Obsidian MCP Server
Connect Claude, ChatGPT, and other AI assistants to your Obsidian vault.
💖 Support This Project
If you find this MCP server useful, please consider supporting its development!
👉 Click here to support this project
Your support helps maintain and improve this tool. Thank you! 🙏
Quick Start
1. Install in your AI app
Claude Desktop:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "@louis030195/mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "your-api-key-here"
}
}
}
}Claude Code:
claude mcp add obsidian "npx -y @louis030195/mcp-obsidian" -s user -e OBSIDIAN_API_KEY="your-api-key-here"2. Enable Obsidian API (Optional - for full features)
- Open Obsidian → Settings → Community plugins
- Turn off Restricted mode → Search "Local REST API" → Install & Enable
- Copy the API key and add to your config:
"env": { "OBSIDIAN_API_KEY": "your-api-key-here" }
That's it! Your AI can now search and read your Obsidian notes.
Other AI Apps
Cursor: Add to settings (Cmd+Shift+P → "Preferences: Open User Settings (JSON)"):
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "@louis030195/mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "your-api-key-here"
}
}
}
}What It Can Do
- Search all your notes
- Find notes even with typos
- Analyze connections between notes
- Execute Dataview queries
- Read specific notes
- List files and folders
Example Questions
- "Search my notes for machine learning"
- "Find all notes I created this week"
- "What meetings did I have last month?"
- "Show me orphaned notes"
Troubleshooting
Obsidian not connecting?
- Make sure Obsidian is running
- Check Local REST API plugin is enabled
- Verify your API key is correct
Need help?
Made with ❤️ for the Obsidian community