loading…
en/
Browse all
louis030195/easy-obsidian-mcp
FreeNot checkedInteract with Obsidian vaults for knowledge management. Create, read, update, and search notes. Works with local Obsidian vaults using filesystem access.
About
Interact with Obsidian vaults for knowledge management. Create, read, update, and search notes. Works with local Obsidian vaults using filesystem access.
README
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
Install louis030195/easy-obsidian-mcp in Claude Desktop, Claude Code & Cursor
Run in your terminal:
claude mcp add louis030195-easy-obsidian-mcp -- npx FAQ
Is louis030195/easy-obsidian-mcp MCP free?
Yes, louis030195/easy-obsidian-mcp MCP is free — one-click install via Unyly at no cost.
Does louis030195/easy-obsidian-mcp need an API key?
No, louis030195/easy-obsidian-mcp runs without API keys or environment variables.
Is louis030195/easy-obsidian-mcp hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install louis030195/easy-obsidian-mcp in Claude Desktop, Claude Code or Cursor?
Open louis030195/easy-obsidian-mcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Compare louis030195/easy-obsidian-mcp with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs