louis030195/easy-obsidian-mcp
📇 🏠 🍎 🪟 🐧 - Interact with Obsidian vaults for knowledge management. Create, read, update, and search notes. Works with local Obsidian vaults using filesystem access.
Quick Install
{
"mcpServers": {
"louis030195-easy-obsidian-mcp": {
"command": "npx",
"args": [
"-y",
"louis030195-easy-obsidian-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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