MCP server to work with Obsidian via the remote REST plugin
This server provides 13 tools with reasonable naming conventions (all start with action verbs like 'list_', 'get_', 'append_', 'delete_'). However, definition quality is hampered by incomplete parameter schemas, missing enum constraints on enumerated parameters, and descriptions that lack sufficient LLM guidance. Tool descriptions are present but often generic (average ~120 chars, below the 194-char baseline). Many parameters lack type definitions in the schema, for instance, 'operation' in obsidian_patch_content accepts only 'append', 'prepend', or 'replace' but is defined as a free-form string without enum constraint, inviting LLM hallucination. The 'type' parameter in obsidian_get_periodic_note similarly lacks an enum. Output schemas are not documented. Error handling is minimal, tools raise ValueError but provide no recovery guidance. The server uses fastmcp framework with STDIO transport, which limits remote accessibility.
Append content to a new or existing file in the vault. :param filepath: Path to the file (relative to vault root). :param content: Content to append to the file.
Return the contents of multiple files in your vault, concatenated with headers. :param filepaths: List of file paths to read.
Complex search for documents using a JsonLogic query. Supports standard JsonLogic operators plus 'glob' and 'regexp' for pattern matching. :param query: JsonLogic query object.
Delete a file or directory from the vault. :param filepath: Path to the file or directory to delete (relative to vault root). :param confirm: Confirmation to delete the file (must be true).
Return the content of a single file in your vault. :param filepath: Path to the relevant file (relative to your vault root).
Enumerated parameters lack enum constraints in schema. 'operation' in obsidian_patch_content accepts only 'append|prepend|replace' but is defined as a free-form string. 'period' in obsidian_get_periodic_note accepts only 'daily|weekly|monthly|quarterly|yearly' but lacks enum. 'type' in obsidian_get_periodic_note accepts only 'content|metadata' but lacks enum. This invites LLM hallucination and defeats the purpose of constrained input patterns.
Output schemas are not documented. Tools return JSON strings without formal schema definitions. LLMs cannot plan downstream tool calls or extract fields reliably. For example, obsidian_simple_search returns formatted results but the response structure is not declared.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 66 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 47 | - | v1 |
Get current periodic note for the specified period. :param period: The period type (daily, weekly, monthly, quarterly, yearly). :param type: The type of data to get ('content' or 'metadata').
Get recently modified files in the vault. :param limit: Maximum number of files to return (default: 10). :param days: Only include files modified within this many days (default: 90).
Get most recent periodic notes for the specified period type. :param period: The period type (daily, weekly, monthly, quarterly, yearly). :param limit: Maximum number of notes to return (default: 5). :param include_content: Whether to include note content (default: false).
Lists all files and directories that exist in a specific Obsidian directory. :param dirpath: Path to list files from (relative to your vault root). Note that empty directories will not be returned.
Lists all files and directories in the root directory of your Obsidian vault.
Insert content into an existing note relative to a heading, block reference, or frontmatter field. :param filepath: Path to the file (relative to vault root). :param operation: Operation to perform (append, prepend, or replace). :param target_type: Type of target to patch (heading, block, or frontmatter). :param target: Target identifier (heading path, block reference, or frontmatter field). :param content: Content to insert.
Create a new file in your vault or update the content of an existing one in your vault. :param filepath: Path to the relevant file (relative to your vault root). :param content: Content of the file you would like to upload.
Simple search for documents matching a specified text query across all files in the vault. Use this tool when you want to do a simple text search. :param query: Text to a simple search for in the vault. :param context_length: How much context to return around the matching string (default: 100).
Error handling lacks recovery guidance. Tools raise ValueError or call await API methods without try-catch blocks or clear error messages. Example: obsidian_delete_file raises 'confirm must be set to true' but provides no guidance on what to do if the file is not found or deletion fails. No distinction between retryable and fatal errors.
The 'query' parameter in obsidian_complex_search is defined as type 'object' with minimal description ('JsonLogic query object'). No schema is provided for what fields the object must contain. LLMs cannot reason about how to construct valid JsonLogic queries.
Tool descriptions lack LLM-optimized guidance on when to use each tool. For instance, obsidian_simple_search and obsidian_complex_search both search the vault, but their distinction is unclear. Description should state: 'Use simple_search for keyword matching; use complex_search for boolean/regex queries.'
No pagination or result limits documented. obsidian_list_files_in_vault and obsidian_list_files_in_dir could return hundreds of files. No limit, offset, or cursor parameters. Description should state max results and offer pagination guidance.
Destructive operations (obsidian_delete_file) require confirmation but lack dry-run capability or pre-execution warnings. A single boolean flag is insufficient, agents should be able to preview what will be deleted before confirming.
Parameter 'context_length' in obsidian_simple_search has a default (100) but no min/max bounds documented. Unbounded numeric parameters allow LLMs to pass absurd values (e.g. 999999) that could break performance.