AI + Obsidian = 🚀
Your assistant. Your notes. Zero friction.
This MCP server lets Claude, ChatGPT+, and other assistants access your vault. Locally, safe frontmatter, no cloud sync.
Recent Updates v0.7.2
- v0.7.2: Security hardening - TOCTOU fixes, regex injection prevention, comprehensive CI/CD (PR #12)
- v0.7.1: Website improvements and copy accuracy updates (PR #10)
- v0.7.0: Clickable Obsidian URI links in AI responses (Issue #5)
Quick Install
Get MCP-Obsidian running in seconds with any MCP-compatible platform
Configure Your AI Platform
📍 Config file locations:
~/Library/Application\ Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json claude mcp add-json obsidian '{...}' inside your project directory
~/Library/Application Support/ChatGPT/chatgpt_config.json %APPDATA%\ChatGPT\chatgpt_config.json ~/.codex/config.toml %USERPROFILE%\.codex\config.toml ⚡ No pre-installation needed! npx automatically downloads and runs the server when needed.
Developers: Test with MCP Inspector
🔍 MCP Inspector provides a web UI to test all MCP methods interactively.
- Testing server functionality before integration
- Debugging MCP method calls and responses
- Exploring available tools and resources
- Development and troubleshooting
🌐 Works with all MCP-compatible platforms: Cursor IDE,
Windsurf, and more coming soon!
Use the same configuration with your platform's MCP server
settings.
🔒 What "private" means:
For commercial Claude users: Your data won't be used for AI training.
You're all set!
Restart your AI platform and you'll see MCP-Obsidian connected. Your AI assistant can now safely read, search, and manage your Obsidian vault.
Core Features
Designed for safety, performance, and developer experience. Every feature gives AI intelligent access without compromising your data.
🔍 Powerful Search
Fast search across your entire vault. AI can locate notes by content, tags, or metadata instantly.
📝 Safe Frontmatter Handling
YAML parser validates and preserves formatting, ensuring safe atomic updates to note metadata.
⚡ File Operations
Read, write, and manage notes safely. Create, update, and organize your vault with AI assistance.
🔒 Security First
Path traversal protection and safe file operations. Controlled AI access through MCP protocol.
Node.js Compatible
Built with Node.js for broad compatibility and ecosystem support.
Token Optimized
Minified JSON field names and compact responses. Less token usage means faster, cheaper API calls.
TypeScript
Fully typed for excellent developer experience.
Open Source
MIT licensed and community driven.
🔧 Complete Toolkit
12 MCP methods for vault management: read/write/patch files, search content, manage tags, update frontmatter, and more. Built for AI assistant integration.
🎯 Multi-Platform
Works with Claude Desktop, ChatGPT+ Desktop, Cursor IDE, and other MCP-compatible AI platforms.
See It In Action
Watch how AI assistants intelligently interact with your Obsidian vault. These examples show real conversations and outcomes.
Add the equation for energy-mass equivalence to my physics notes
🔧 MCP-Obsidian: Using patch_note... Request:
{
"path": "Physics/Relativity.md",
"oldString": "## Energy and Mass",
"newString": "## Energy and Mass\n\nE = mc²",
"prettyPrint": true
}Response:
{
"success": true,
"message": "Successfully replaced 1 occurrence",
"matchCount": 1
}✅ Done! Added Einstein's equation to your notes. Only the specific section was updated - no full file rewrite needed.
Technical Details
Ready to experience this level of AI-powered note management?
Get Started NowUsage Examples
Practical prompts you can try with your AI assistant and MCP-Obsidian.
Find my productivity notes and summarize the key concepts
Find notes and read their content for analysis
Mark all my project notes as completed
Batch update frontmatter across multiple notes
Example Prompts
Once MCP-Obsidian is set up, these prompts demonstrate search, read, and write operations in a single flow.
Get Started NowWhy Choose MCP-Obsidian?
See how MCP-Obsidian compares to generic filesystem access and direct file manipulation. Purpose-built for Obsidian means better safety, performance, and intelligence.