4.5k GitHub stars and counting — MarkusPfundstein/mcp-obsidian is a Python project TopGit is tracking across repositories on the platform. MCP server that interacts with Obsidian via the Obsidian rest API community plugin
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
MCP server to interact with Obsidian via the Local REST API community plugin.
Components
Tools
The server implements multiple tools to interact with Obsidian:
list_files_in_vault: Lists all files and directories in the root directory of your Obsidian vault
list_files_in_dir: Lists all files and directories in a specific Obsidian directory
get_file_contents: Return the content of a single file in your vault.
search: Search for documents matching a specified text query across all files in the vault
patch_content: Insert content into an existing note relative to a heading, block reference, or frontmatter field.
append_content: Append content to a new or existing file in the vault.
delete_file: Delete a file or directory from your vault.
Example prompts
Its good to first instruct Claude to use Obsidian. Then it will always call the tool.
The use prompts like this:
Get the contents of the last architecture call note and summarize them
Search for all files where Azure CosmosDb is mentioned and quickly explain to me the context in which it is mentioned
Summarize the last meeting notes and put them into a new note 'summary meeting.md'. Add an introduction so that I can send it via email.
Requirements
Python >= 3.11
mcp Python SDK >=1.1.0,<2.0.0 (pinned in pyproject.toml). mcp-obsidian currently registers its tool handlers via the mcp 1.x low-level Server API (@app.list_tools() / @app.call_tool()), which was removed in mcp 2.0. Installing with an unconstrained mcp>=2.0 will crash at import with AttributeError: 'Server' object has no attribute 'list_tools'.
Configuration
Obsidian REST API Key
There are two ways to configure the environment with the Obsidian REST API Key.
You can run the server in a container instead of installing uv/Python locally.
Copy .env.example to .env and fill in your Obsidian REST API key:
cp .env.example .env
By default OBSIDIAN_HOST is set to host.docker.internal, which resolves to
your host machine from inside the container (works on Linux, Mac and Windows).
Build the image:
docker compose build
Point your MCP client at the container. Since MCP speaks JSON-RPC over
stdio, the client must run it with stdin attached and no pseudo-TTY — use
docker compose run --rm -T, not docker compose up:
Does MarkusPfundstein/mcp-obsidian have a project website?
No homepage URL was recorded for MarkusPfundstein/mcp-obsidian in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How many stars does MarkusPfundstein/mcp-obsidian have?
MarkusPfundstein/mcp-obsidian has 4.5k GitHub stars — refresh the page for the live number, or check github.com/MarkusPfundstein/mcp-obsidian. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is MarkusPfundstein/mcp-obsidian open source?
Yes — MarkusPfundstein/mcp-obsidian ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/MarkusPfundstein/mcp-obsidian.
What is MarkusPfundstein/mcp-obsidian?
MarkusPfundstein/mcp-obsidian (MarkusPfundstein/mcp-obsidian) is a Python project on GitHub. From the project's own README: MCP server that interacts with Obsidian via the Obsidian rest API community plugin
Where do I read more about MarkusPfundstein/mcp-obsidian?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/MarkusPfundstein/mcp-obsidian is the definitive source.
Read full README in the tab above.
Curious whether mcp-obsidian is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about mcp-obsidian.