MCP server for Obsidian (TypeScript + Bun)
A Model-Context-Protocol (MCP) server that lets Claude (or any MCP-compatible LLM) interact with your Obsidian vault through the Local REST API community plugin – written in and runnable with .
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y @ueric/[email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add fazer-ai-mcp-obsidian-github -- npx -y @ueric/mcp-obsidian@1.1.1In einem Terminal ausführen.
{ "mcpServers": { "fazer-ai-mcp-obsidian-github": { "command": "npx", "args": [ "-y", "@ueric/[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
A Model-Context-Protocol (MCP) server that lets Claude (or any MCP-compatible LLM) interact with your Obsidian vault through the Local REST API community plugin – written in and runnable with .
MCP server for Obsidian (TypeScript + Bun)
See Obsidian's Local REST API specifications for more details.
# Summarize the latest “architecture call” note
# (Claude will transparently call list_files_in_vault → get_file_contents)
Get the contents of the last “architecture call” note and summarize them.
# Find all mentions of Cosmos DB
Search for all files where “Azure CosmosDb” is mentioned and explain the context briefly.
# Create a summary note
Summarize yesterday’s meeting and save it as “summaries/2025-04-24-meeting.md”. Add a short intro suitable for e-mail.
There are two ways to pass the Obsidian API key to the server:
env field in your Claude (or other client) MCP-server declaration:// claude_desktop_config.json
{
"mcpServers": {
"@fazer-ai/mcp-obsidian": {
"command": "bunx",
"args": ["@fazer-ai/mcp-obsidian@latest"],
"env": {
"OBSIDIAN_API_KEY": "your-obsidian-api-key"
}
}
}
}
[!NOTE] Use
@fazer-ai/mcp-obsidian@latestto ensure you always run the most up to date version of the server.
.env file. Place the key in the .env you created above. Note it must be placed in the working directory where the MCP server is running.You can use the .env.example file as reference to create your own .env file.
OBSIDIAN_API_KEY= # Obtain this from the plugin settings in Obsidian
OBSIDIAN_PROTOCOL=http
OBSIDIAN_HOST=localhost
OBSIDIAN_PORT=27123 # Port the Local REST API plugin is bound to
After cloning this repo, you can update Claude's config to run your local version of the server instead of pulling from npm. This is useful for quickly testing changes before publishing.
[!NOTE] Keep in mind any changes you make on the code will only take effect after restarting the Claude Desktop app.
bun install to install dependencies.claude_desktop_config.json to point to your local version of the server:// claude_desktop_config.json
{
"mcpServers": {
"@fazer-ai/mcp-obsidian": {
"command": "bun",
"args": ["/path/to/repo/src/index.ts"],
"env": {
"OBSIDIAN_API_KEY": "your-obsidian-api-key"
}
}
}
}
[!IMPORTANT] Note we use
buninstead ofbunxhere.
MCP servers talk over stdio, so normal debuggers aren’t helpful.
Use the MCP Inspector:
npx @modelcontextprotocol/inspector bun /path/to/repo/src/index.ts
Open the URL it prints to step through requests (usually http://localhost:6274), inspect tool calls, and watch logs in real time.
package.json.bun publish.MIT – see LICENSE.
MCP server for Obsidian (TypeScript + Bun)
{ "mcpServers": { "fazer-ai-mcp-obsidian-github": { "command": "npx", "args": [ "-y", "@ueric/[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
MCP Obsidian läuft lokal über stdio.
Zuletzt geprüft: 2026-10-27. MCP server for Obsidian (TypeScript + Bun)