The Teldrive MCP server enables interaction with your Teldrive storage through powerful tools. Key capabilities:
- Advanced file searching with multi-filter support
- Folder navigation and creation
- File content retrieval with automatic format handling
Find files/folders with combinable filters:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "project alpha",
"searchType": "text", // "text" (default) or "regex",
"limit": 8,
"page": 1,
"limit": 20,
"category": ["document", "image"],
"type": "file"
}
</arguments>
</use_mcp_tool>
Key Parameters:
query
: Filename/text searchsearchType
: text
for literal matches (default), regex
for regular expressionscategory
: Multi-select: ["document","image","video","audio","archive","other"]
type
: file
or folder
limit/page
: Pagination control
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "Taylor Swift",
"searchType": "text"
}
</arguments>
</use_mcp_tool>
Find all files with a 4-digit year prefix:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "\\d{4}-.*\\.txt",
"searchType": "regex",
"category": ["document"]
}
</arguments>
</use_mcp_tool>
Find file or folder with exact name
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"name": "hello.pdf",
"type": "file",
"limit":1
}
</arguments>
<arguments>
{
"name": "test",
"type": "folder",
"limit": 1
}
</arguments>
</use_mcp_tool>
View folder contents (requires folder ID):
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>list_files</tool_name>
<arguments>
{
"folder_id": "F:12345",
"limit": 100
}
</arguments>
</use_mcp_tool>
Create folders anywhere in your structure:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>create_folder</tool_name>
<arguments>
{
"path": "/Clients/Acme Corp",
"name": "Contracts"
}
</arguments>
</use_mcp_tool>
Retrieve content by file ID with automatic formatting:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>read_file</tool_name>
<arguments>
{"file_id": "F:98765"}
</arguments>
</use_mcp_tool>
Format Handling:
- Text/JSON: Raw text
- Images: Base64 for direct embedding
- Audio: Base64 for playback via
<audio src="data:audio/mp3;base64,...">
- Binary: Not directly readable (use with preview tools)
Find marketing PDFs and images:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "Q3 campaign",
"category": ["document", "image"],
"limit": 5
}
</arguments>
</use_mcp_tool>
Find newest videos (pagination example):
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"category": ["video"],
"limit": 10,
"page": 1
}
</arguments>
</use_mcp_tool>
Create nested folders and confirm:
<!-- Create parent folder -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>create_folder</tool_name>
<arguments>
{"path": "/", "name": "Research"}
</arguments>
</use_mcp_tool>
<!-- Create subfolder -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>create_folder</tool_name>
<arguments>
{"path": "/Research", "name": "Competitor Analysis"}
</arguments>
</use_mcp_tool>
<!-- Verify structure -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{"query": "Competitor Analysis", "type": "folder"}
</arguments>
</use_mcp_tool>
Navigate folder hierarchy:
<!-- Find project root -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "Project Phoenix",
"type": "folder",
"limit": 1
}
</arguments>
</use_mcp_tool>
<!-- List contents (using ID from search) -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>list_files</tool_name>
<arguments>
{
"folder_id": "F:54321",
"limit": 50
}
</arguments>
</use_mcp_tool>
Find and read archived reports:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "financial_audit",
"category": ["archive"]
}
</arguments>
</use_mcp_tool>
<!-- Extract and read (using file ID from results) -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>read_file</tool_name>
<arguments>
{"file_id": "F:ZIP001"}
</arguments>
</use_mcp_tool>
Find and process podcast episodes:
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
"query": "podcast_episode_*",
"category": ["audio"],
"limit": 3
}
</arguments>
</use_mcp_tool>
<!-- Process each found ID independently -->
<use_mcp_tool>
<server_name>teldrive</server_name>
<tool_name>read_file</tool_name>
<arguments>
{"file_id": "F:AUD123"}
</arguments>
</use_mcp_tool>
-
Precision Searching: Combine
category+query
for focused results
Category Filtering Guide
:
┌─────────────┬──────────────────────────────────┐
│ Category │ Best For │
├─────────────┼──────────────────────────────────┤
│ document │ PDF, Word, Excel, Text files │
│ image │ JPG, PNG, GIF visual content │
│ video │ MP4, MOV, AVI videos │
│ audio │ MP3, WAV, OGG sound files │
│ archive │ ZIP, RAR compressed bundles │
│ other │ Unclassified file types │
└─────────────┴──────────────────────────────────┘
-
ID Handling: Always reference files by ID (not names) after initial search/list
-
Pagination: For large results, use
limit
+ page
parameters
page=1 limit=20
→ First 20 results
page=2 limit=20
→ Next 20 results
-
Resource Notation: Reference files via URI in actions:
teldrive:///F:12345
(for downstream processing)
-
File Size Awareness:
- Text files <1MB: Direct reading
- Media files: Use preview/metadata extraction
-
5MB files: Use chunked reading strategies