Repolode
Submit
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

MCP server that lets AI assistants read, search, append to and delete notes in an Obsidian vault via the Local REST API plugin.

View on GitHub
Stars
4,521
Forks
508
Open issues
107
Last commit
2 months ago

What is it?

mcp-obsidian is a Model Context Protocol (MCP) server that connects AI clients such as Claude Desktop to an Obsidian vault. It works through the Local REST API community plugin for Obsidian, so Obsidian must be running with that plugin enabled and an API key configured.

Once connected, the assistant can list files and folders in a vault, read the contents of a note, run a text search across all files, insert content relative to a heading, block reference or frontmatter field, append content to a new or existing file, and delete files or directories. Configuration uses an API key plus optional host and port, which default to 127.0.0.1 and 27124.

The project can be run with uvx, from a local uv environment, or in a Docker container that reaches the host through host.docker.internal. It requires Python 3.11 or later and an mcp Python SDK version below 2.0.

Key features

  • 01Lists files and directories in the vault root or a specific folder.
  • 02Reads the full content of a single note.
  • 03Searches text across all files in the vault.
  • 04Inserts content into notes relative to headings, block references or frontmatter fields.
  • 05Appends content to new or existing files and deletes files or directories.

Use cases

  • Asking an AI assistant to summarize or explain notes stored in Obsidian.
  • Searching a vault for every mention of a topic and reviewing the surrounding context.
  • Generating a new meeting summary note from existing notes automatically.
  • Letting an AI assistant maintain and update notes in a personal knowledge base.

Quick start

  1. 1

    Install and enable the Obsidian Local REST API community plugin, then copy its API key

  2. 2

    Add the server to your MCP client config with OBSIDIAN_API_KEY, OBSIDIAN_HOST and OBSIDIAN_PORT set

  3. 3

    Run the published server with uvx

    uvx mcp-obsidian

Things to know

  • Requires the Obsidian Local REST API community plugin to be installed and running in Obsidian.
  • Requires Python 3.11 or newer, and the mcp dependency must stay below version 2.0.

In collections

Open-source AI agent frameworks & appsMCP servers

Topics

#mcp#obsidian#notes#knowledge-management#llm#python#ai-agent

FAQ

What is mcp-obsidian?
MCP server that lets AI assistants read, search, append to and delete notes in an Obsidian vault via the Local REST API plugin. mcp-obsidian is a Model Context Protocol (MCP) server that connects AI clients such as Claude Desktop to an Obsidian vault. It works through the Local REST API community plugin for Obsidian, so Obsidian must be running with that plugin enabled and an API key configured.
Is mcp-obsidian free to use? What license does it have?
mcp-obsidian is open source under the MIT license. Check the license terms before using it in commercial products.
Is mcp-obsidian still maintained?
Updated within 6 months. The last commit to mcp-obsidian was on Aug 31, 2026.
What can I use mcp-obsidian for?
Asking an AI assistant to summarize or explain notes stored in Obsidian. Searching a vault for every mention of a topic and reviewing the surrounding context. Generating a new meeting summary note from existing notes automatically. Letting an AI assistant maintain and update notes in a personal knowledge base.
How do I install mcp-obsidian?
Install and enable the Obsidian Local REST API community plugin, then copy its API key Add the server to your MCP client config with OBSIDIAN_API_KEY, OBSIDIAN_HOST and OBSIDIAN_PORT set Run the published server with uvx: uvx mcp-obsidian
Where can I get mcp-obsidian?
The source code and installation instructions are on GitHub: https://github.com/MarkusPfundstein/mcp-obsidian

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects