Obsidian MCP Server

A Model Context Protocol (MCP) server for git-backed Obsidian vaults. Access and manage your notes through Claude, ChatGPT, and other LLMs by syncing changes via git.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
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 for git-backed Obsidian vaults. Access and manage your notes through Claude, ChatGPT, and other LLMs by syncing changes via git.
MCP server for git-backed Obsidian vaults. Access and manage notes through Claude, ChatGPT, and other LLMs with automatic git sync. Supports local (stdio/HTTP) and remote (AWS Lambda) deployment.
This MCP server provides 18 tools and 1 resource to interact with your Obsidian vault through LLMs:
Tool Categories:
Deployment Modes:
Get started with Claude Desktop in 3 steps using Docker:
# 1. Download the example environment file
curl -O https://raw.githubusercontent.com/eddmann/obsidian-mcp/main/.env.example
mv .env.example obsidian-mcp.env
# 2. Edit obsidian-mcp.env with your vault repo and git token
# Required fields:
# VAULT_REPO=https://github.com/username/vault-repo.git
# VAULT_BRANCH=main
# GIT_TOKEN=your_token_here
3. Add to Claude Desktop config:
{
"mcpServers": {
"obsidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env",
"ghcr.io/eddmann/obsidian-mcp:latest",
"stdio"
]
}
}
}
{
"mcpServers": {
"obsidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"C:\\ABSOLUTE\\PATH\\TO\\obsidian-mcp.env:/app/.env",
"ghcr.io/eddmann/obsidian-mcp:latest",
"stdio"
]
}
}
}
Restart Claude Desktop and start chatting with your vault!
# 1. Clone and install
git clone https://github.com/eddmann/obsidian-mcp
cd obsidian-mcp
npm install
# 2. Configure credentials
cp .env.example .env
# Edit .env with your vault repo and git token
3. Add to Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "npm",
"args": ["run", "--prefix", "/ABSOLUTE/PATH/TO/obsidian-mcp", "dev"]
}
}
}
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "npm",
"args": ["run", "--prefix", "C:\\ABSOLUTE\\PATH\\TO\\obsidian-mcp", "dev"]
}
}
}
This server is designed for git-backed Obsidian vaults managed by plugins like obsidian-git.
graph LR
A[Git Repository] -->|1. Clone/Pull| B[MCP Server]
B -->|2. LLM Modifies| C[Local Vault Copy]
C -->|3. Auto Commit & Push| A
A -->|4. Sync| D[Obsidian Clients]
style B fill:#4a9eff
style C fill:#7c3aed
Workflow:
This enables LLM access without Obsidian being open, with all changes synchronized via git.
Using Docker:
See Quick Start above for the recommended Docker-based setup.
# Clone and install
git clone https://github.com/eddmann/obsidian-mcp
cd obsidian-mcp
npm install
# Configure credentials
cp .env.example .env
# Edit .env with your vault repo and git token
Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "npm",
"args": ["run", "--prefix", "/ABSOLUTE/PATH/TO/obsidian-mcp", "dev"]
}
}
}
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "npm",
"args": ["run", "--prefix", "C:\\ABSOLUTE\\PATH\\TO\\obsidian-mcp", "dev"]
}
}
}
Run the server in HTTP mode with OAuth authentication:
Using Docker:
docker run -p 3000:3000 --rm \
-v "/ABSOLUTE/PATH/TO/obsidian-mcp.env:/app/.env" \
ghcr.io/eddmann/obsidian-mcp:latest \
http
Using npm:
# First clone the repo if you haven't already
git clone https://github.com/eddmann/obsidian-mcp
cd obsidian-mcp
npm install
# Configure all environment variables (including OAuth)
cp .env.example .env
# Edit .env
# Run HTTP server
npm run dev:http
Required environment variables:
.env.example)OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET, PERSONAL_AUTH_TOKEN, BASE_URLSee Deployment Guide for detailed configuration and ChatGPT integration.
Deploy to AWS Lambda for remote access with DynamoDB session storage:
# 1. Clone the repository
git clone https://github.com/eddmann/obsidian-mcp
cd obsidian-mcp
# 2. Install dependencies
npm install
# 3. Configure all environment variables (including OAuth)
cp .env.example .env
# Edit .env
# 4. Deploy to AWS
npm run cdk:deploy
What gets deployed:
Cleanup:
npm run cdk:destroy
See Deployment Guide for complete setup instructions.
Ask your LLM to interact with your vault using natural language:
"Can you read my project note at Projects/MCP-Server.md?"
"Read all my daily notes from the past week"
"Create a new meeting note in Work/Meetings for today's standup"
"Add a task list to my project plan under the Action Items section"
"Set up a new folder structure for my research papers"
"What markdown files do I have in my vault?"
"Show me all the PDFs in my Resources folder"
"Find all my notes about machine learning"
"Where did I write about TODO items?"
"Search my Projects folder for anything about deployment"
"Tag my meeting note with work and urgent"
"I want to consolidate my todo tags into a single task tag"
"What tags am I using the most?"
"Log today's work: I implemented OAuth for the MCP server using TypeScript and AWS"
"Add a journal entry about my Rust research - I learned about async patterns and tokio"
"Journal this: spent time learning TypeScript generics and created some helper utilities"
See Tool Documentation for detailed usage and examples.
See Tool Documentation for detailed usage and examples.
See Tool Documentation for detailed usage and examples.
See Tool Documentation for detailed usage and examples.
See Tool Documentation for detailed usage and examples.
MCP resources provide contextual information that LLMs can access on-demand.
If your vault contains a README.md file in its root directory, LLMs can access it to understand how your vault is organized.
MCP server for git-backed Obsidian vaults. Access and manage notes through Claude, ChatGPT, and other LLMs with automatic git sync. Supports local (stdio/HTTP) and remote (AWS Lambda) deployment.
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.
Obsidian läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. MCP server for git-backed Obsidian vaults. Access and manage notes through Claude, ChatGPT, and other LLMs with automatic git sync. Supports local (stdio/HTTP) and remote (AWS Lambda) deployment.