Obsidian MCP Logo

About Obsidian MCP

Obsidian MCP is a Model Context Protocol server that connects AI agents and development tools to an Obsidian vault, enabling programmatic reading, writing, searching, and managing of notes through the Obsidian Local REST API plugin. It provides eight primary tools that cover the full spectrum of vault operations. The server supports reading notes in markdown or JSON format with file statistics, modifying content through append, prepend, or overwrite operations, and performing search-and-replace with regex support. A global search tool conducts vault-wide queries with path and date filters and paginated results. Dedicated frontmatter and tag management tools handle YAML metadata atomically without rewriting entire files. The vault listing tool supports filtering by extension and name patterns. An intelligent in-memory caching system improves performance and provides fallback search when the REST API is temporarily unavailable. The server bridges Obsidian into AI workflows, letting LLMs access and modify a knowledge base as part of research, writing, or coding tasks. Common use cases include automating note generation, batch-updating frontmatter across files, searching vaults through natural language, and maintaining linked knowledge graphs. It works with Claude Desktop, Claude Code, Cursor, and other MCP clients.