Obsidian Codex MCP
Local-first MCP server for working with an Obsidian vault.
- No Obsidian plugin required
- No API key required
- No cloud service required
- No Obsidian running in the background
This is for people who want MCP clients to work directly with markdown files on disk.
Independent open-source project. Not affiliated with Obsidian, Anthropic, OpenAI, or any MCP client.
What it does
It lets MCP clients work with your vault to:
- read and search notes
- create and update notes
- generate summaries, status reports, and release notes
- automate local knowledge workflows
All directly against your local markdown files.
Best for
- Codex users who want safe local access to an Obsidian vault
- Claude Desktop, Cline, Cursor, and other MCP clients that can run a local Python server
- Developers who prefer filesystem-based Obsidian automation over the Local REST API plugin
- Personal knowledge bases, project logs, daily notes, task notes, and markdown-first workflows
Why this exists
There are already a handful of Obsidian MCP servers. Many depend on the Obsidian Local REST API plugin or run as an Obsidian plugin. This project is intentionally simpler:
