Docs › AI integration
MCP tool reference
The 50+ tools the MCP server exposes, grouped by purpose.
The bundled MCP server exposes 50+ tools across vault, modules, rules, email, and cloud sync. Verified against src-tauri/src/mcp/tools.rs.
Vault access
| Tool | Purpose |
|---|---|
| read_file | Read a single file by path. |
| write_file | Write or overwrite a file. |
| search_vault | Full-text search across the vault. |
| list_files | List files in a folder with metadata. |
| get_context | Get pre-compiled context for a folder, project, or entity. |
| get_vault_info | Vault-level metadata. |
| get_vault_index | Structured index of the whole vault. |
| get_all_tags | Every tag in use. |
| get_files_by_tag | List files by tag. |
| get_backlinks | List documents linking to a given file. |
Modules — records & schemas
| Tool | Purpose |
|---|---|
| get_data_modules | List installed Data Form modules. |
| get_module_schema | Read a module's field schema. |
| get_module_form_schema | The form schema (UI metadata) for a module. |
| create_module_record | Create a typed record (client, invoice, task, etc.). |
| list_module_records | List records, filtered, sorted, paginated. |
| search_module_records | Search records by content. |
| update_module_record | Patch a record. |
| archive_module_record | Archive without deleting. |
| delete_module_record | Delete (soft, to trash). |
| trigger_module_form | Pop a form for the user to fill in. |
Modules — vault folders & general
| Tool | Purpose |
|---|---|
| get_vault_folder_modules | List installed Workspace modules. |
| create_vault_folder_entity | Create a typed entity (e.g. a new client folder). |
| list_vault_folder_entities | List entities in a workspace. |
| get_folder_context | Read a folder's about page plus its installed modules. |
| execute_module_pipeline | Trigger a named pipeline (e.g. "send invoice"). |
| get_aggregation_view | Read an aggregation (e.g. master task list). |
| recommend_modules | Ask the system to suggest modules based on use. |
| get_installed_modules | List every installed module. |
Rules
| Tool | Purpose |
|---|---|
| create_rule | Add a folder rule. |
| update_rule | Edit a folder rule. |
| delete_rule | Remove a folder rule. |
| toggle_rule | Enable / disable without deleting. |
| list_rules | List rules at any level. |
Email (Gmail)
Available when the Gmail module is installed and an account is connected: search_emails, read_thread, list_unread, draft_reply, draft_new, send_draft, archive_emails, label_emails, get_email_summary, download_attachment, triage_inbox, get_email_routing_rules, create_email_routing_rule, delete_email_routing_rule, classify_email_test.
Cloud sync (Drive & OneDrive)
Available when sync is configured: search_drive, browse_drive_folder, get_drive_file, preview_drive_file, search_onedrive, browse_onedrive_folder, get_onedrive_file, preview_onedrive_file.