Verfy

MCP servers / mcp-obsidian

MCP tool changes

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.

Tools in 0.2.3
ToolDescriptionPin
obsidian_list_files_in_dirLists all files and directories that exist in a specific Obsidian directory.8667ed91b79e
obsidian_list_files_in_vaultLists all files and directories in the root directory of your Obsidian vault.0a6cb8cff7f1
obsidian_get_file_contentsReturn the content of a single file in your vault.d1ad0793ea01
obsidian_simple_searchSimple 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 search6274223b8b4c
obsidian_patch_contentInsert 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_contentAppend content to a new or existing file in the vault.39f2e47dee79
obsidian_put_contentCreates 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_fileDelete a file or directory from the vault.2b45acf92091
obsidian_complex_searchComplex 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_tagFind 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_frontmatterReturn 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_contentsReturn the contents of multiple files in your vault, concatenated with headers.b3365fb5de89
obsidian_get_periodic_noteGet current periodic note for the specified period.89c3994dcc1a
obsidian_get_recent_periodic_notesGet most recent periodic notes for the specified period type.150fd6e6f4f6
obsidian_get_recent_changesGet 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@v1

Maintain this server? Run the same check on your releases and add the Locked by Verfy badge to your README.