MCP server for Obsidian (TypeScript + Bun)
@fazer-ai
About MCP server for Obsidian (TypeScript + Bun)
MCP server for Obsidian (TypeScript + Bun)
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-obsidian-fazer-ai": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"bun",
"/path/to/repo/src/index.ts"
]
}
}
}Tools
24Returns basic details about the Obsidian Local REST API server and your authentication status
Deletes the note that is currently active in the Obsidian UI
Retrieves the full content of the active note (Markdown or JSON view)
Inserts, replaces or prepends content in the active note relative to a heading, block reference, or front-matter field
Appends Markdown to the end of the active note
Replaces the entire body of the active note
Lists every command available in Obsidian’s command palette
Executes a specific Obsidian command by its ID
Opens the given file inside Obsidian (creates it if missing); optional flag to open in a new leaf
Deletes the current daily / weekly / monthly / quarterly / yearly note for the requested period
Returns the content of the current periodic note for the requested period
Inserts / replaces content in a periodic note relative to a heading, block reference, or front-matter field
Appends Markdown to the periodic note (creates it if it doesn’t exist)
Replaces the entire body of a periodic note
Runs a Dataview-DQL query across the vault and returns matching rows
Runs a JsonLogic query against structured note metadata
Performs a plain-text fuzzy search with optional surrounding context
Lists all files and directories at the **root** of your vault
Lists files and directories inside a **specific folder** of the vault
Deletes a specific file (or directory) in the vault
Retrieves the content of a file in the vault (Markdown or JSON view)
Inserts / replaces content in an arbitrary file relative to a heading, block reference, or front-matter field
Appends Markdown to a file (creates it if it doesn’t exist)
Creates a new file or replaces the entire body of an existing file
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.
Frequently asked questions
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.
Basic information
More Memory & Knowledge MCP servers
Anytype MCP Server
anyprotoAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.
Obsidian MCP Server
cyanheadsRead, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.
Tempreon
TempreonPerson-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.
Basic Memory
basicmachines-coAI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
Notion MCP Server
makenotionOfficial Notion MCP Server
Comments