MCP server for Obsidian (TypeScript + Bun)
@fazer-ai
MCP server for Obsidian (TypeScript + Bun)
Overview
What is MCP server for Obsidian (TypeScript + Bun)?
An MCP server that lets Claude or any MCP-compatible LLM interact with your Obsidian vault through the Local REST API community plugin. It is written in TypeScript and runnable with bunx.
How to use MCP server for Obsidian (TypeScript + Bun)?
Install and run with bunx @fazer-ai/mcp-obsidian@latest. Configure the API key via the env field in your MCP client config (e.g., claude_desktop_config.json) or an .env file. The Obsidian Local REST API plugin must be installed and running.
Key features of MCP server for Obsidian (TypeScript + Bun)
- 24 tools for reading, writing, and managing notes
- Supports periodic notes (daily, weekly, monthly, etc.)
- Executes Obsidian commands by their ID
- Searches with fuzzy, Dataview-DQL, and JsonLogic queries
- Opens, creates, and deletes files in the vault
- Patches content relative to headings or block references
Use cases of MCP server for Obsidian (TypeScript + Bun)
- Summarize meeting notes by reading the active note
- Search across the vault for keywords like “Azure Cosmos Db”
- Create a daily summary note and append to a period note
- Open a specific file in Obsidian from a prompt
- Delete outdated periodic notes automatically
FAQ from MCP server for Obsidian (TypeScript + Bun)
How do I provide my Obsidian API key?
You can set the OBSIDIAN_API_KEY environment variable in your MCP client config (recommended) or place it in a .env file in the working directory.
What runtime does the server require?
It requires Bun to run. You can use bunx to execute the npm package directly, or run a local copy with bun.
How do I debug the server?
Use the MCP Inspector: run npx @modelcontextprotocol/inspector bun /path/to/src/index.ts and open the printed URL (usually http://localhost:6274).
How do I run a local development version?
Clone the repo, run bun install, and point Claude’s config to your local src/index.ts using bun instead of bunx.
Where does the API key come from?
It is obtained from the Local REST API plugin settings inside Obsidian. The server also uses configurable OBSIDIAN_PROTOCOL, OBSIDIAN_HOST, and OBSIDIAN_PORT (default 27123) environment variables.
