Skip to content
Kitbay
MCP server

mcp-obsidian

Runs locallyMITUpdated on Aug 31, 20264,530GitHub starsCan change dataNeeds an API key

A Python MCP server that runs locally over stdio and reaches an Obsidian vault through the community Local REST API plugin, so Obsidian has to be running with that plugin enabled and its API key passed in as an environment variable.

What it does

A Python MCP server that runs locally over stdio and reaches an Obsidian vault through the community Local REST API plugin, so Obsidian has to be running with that plugin enabled and its API key passed in as an environment variable. The assistant can browse vault folders, open a single note, run a text search across all files, add text to the end of a note, insert text under a given heading, block reference or frontmatter field, and delete files or folders. It is started with uvx or inside a Docker container, and the README gives a Claude Desktop configuration. It needs Python 3.11 or later and the 1.x MCP Python SDK.

Capabilities

  • List files and folders in an Obsidian vault
  • Read the contents of a note
  • Search all vault files for text
  • Append text or insert it under a heading, block or frontmatter field
  • Delete files or folders