MCP servers / mcp-obsidian
mcp-obsidian
Only one release started (0.2.3), so there is nothing to compare yet. Its tools are below.
PyPI package · last recorded on 13 November 2026 on a clean machine with placeholder settings; only tools/list was sent. A changed description is not a vulnerability. PyPI page · Method and limits · this data as JSON.
Release by release
Releases tried: 0.1.0 (2024-12-04), did not start; 0.2.0 (2024-12-04), did not start; 0.2.1 (2024-12-05), did not start; 0.2.2 (2025-04-01), did not start; 0.2.3 (2026-08-20).
Tools in 0.2.3
The pin is the SHA-256 of the tool's name, description and input schema, as verfy.lock records it. The same pin in your lock means your agent reads this exact definition. Verfy 0.16.0 and later also pin a tool's title, annotations and output schema when the server sends them, so such a tool shows a different pin in your lock.
| Tool | Description | Pin |
|---|---|---|
| obsidian_list_files_in_dir | Lists all files and directories that exist in a specific Obsidian directory. | 8667ed91b79e |
| obsidian_list_files_in_vault | Lists all files and directories in the root directory of your Obsidian vault. | 0a6cb8cff7f1 |
| obsidian_get_file_contents | Return the content of a single file in your vault. | d1ad0793ea01 |
| obsidian_simple_search | 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 | 6274223b8b4c |
| obsidian_patch_content | Insert content into an existing note relative to a heading, block reference, or frontmatter field. For target_type='heading', target must be the fully qualified heading path joined with '::' (e.g. 'Outer::Inner'). Bare heading names (without '::') will be auto-qualified if they match exactly one heading in the file. | 678453fc5e41 |
| obsidian_append_content | Append content to a new or existing file in the vault. | 39f2e47dee79 |
| obsidian_put_content | Creates a new file, or COMPLETELY OVERWRITES the content of an existing file. The previous content is lost. Use `obsidian_append_content` to add content to a file without erasing what's already there. Use `obsidian_patch_content` to modify a specific heading, block or frontmatter field while keeping the rest intact. | d4edf4e61241 |
| obsidian_delete_file | Delete a file or directory from the vault. | 2b45acf92091 |
| obsidian_complex_search | Complex search for documents using a JsonLogic query. Supports standard JsonLogic operators plus 'glob' and 'regexp' for pattern matching. Results must be non-falsy. Use this tool when you want to do a complex search, e.g. for all documents with certain tags etc. ALWAYS follow query syntax in examples. Examples 1. Match all markdown files {"glob": ["*.md", {"var": "path"}]} 2. Match all markdown files with 1221 substring inside them { "and": [ { "glob": ["*.md", {"var": "path"}] }, { "regexp": [".*1221.*", {"var": "content"}] } ] } 3. Match all markdown files in Work folder containing name Keaton { "and": [ { "glob": ["*.md", {"var": "path"}] }, { "regexp": [".*Work.*", {"var": "path"}] }, { "regexp": ["Keaton", {"var": "content"}] } ] } | 1e37e9db489a |
| obsidian_search_by_tag | Find all notes carrying a specific tag. Matches the note's parsed tag set (YAML frontmatter `tags:` plus inline `#tag` occurrences), so hits on the tag name inside ordinary prose are NOT returned. Pass the tag without the leading '#'. Hierarchical-tag matching is exact — searching for 'work' will not match notes tagged 'work/tasks'. Optionally scope to a vault subdirectory. | 6ca7bfd31a15 |
| obsidian_get_frontmatter | Return just the YAML frontmatter of a note as a parsed JSON object. Lighter than obsidian_get_file_contents when you only need metadata (tags, aliases, status fields, etc.). Returns an empty object for notes without frontmatter. | 6caa14d27e86 |
| obsidian_batch_get_file_contents | Return the contents of multiple files in your vault, concatenated with headers. | b3365fb5de89 |
| obsidian_get_periodic_note | Get current periodic note for the specified period. | 89c3994dcc1a |
| obsidian_get_recent_periodic_notes | Get most recent periodic notes for the specified period type. | 150fd6e6f4f6 |
| obsidian_get_recent_changes | Get recently modified files in the vault. | 056e8682e62d |
Lock these tools
Pin what mcp-obsidian serves you today, commit the lock, and a pull request fails when a tool changes, with the text before and after. Pin the package version in your MCP config as well.
$ pip install verfy
$ verfy lock check --update # shows each tool, then writes verfy.lock
$ git add verfy.lock# .github/workflows/verfy.yml, after actions/checkout
- uses: verfy-dev/verfy-action@v1Maintain this server? Run the same check on your releases and add the Locked by Verfy badge to your README.