About louis030195/easy-obsidian-mcp
louis030195/easy-obsidian-mcp is an MCP server published by louis030195 in the Automation category: wire your brain to AGI through the best obsidian MCP.
The repository has 17 stars and 4 forks, with the last commit 12 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/louis030195/easy-obsidian-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
obsidian_fuzzy_searchfuzzy search for notes using approximate matching. works even when obsidian api is unavailable. great for finding notes when you
Parameters not published.
obsidian_get_file_contentretrieves the full content of a specific file from the obsidian vault.
Parameters not published.
obsidian_graph_searchanalyze links and connections between notes. finds orphaned notes, builds link graphs, and discovers note relationships. works without obsidian api.
Parameters not published.
obsidian_list_fileslists files and folders within a specified directory in the obsidian vault. if no directory is specified, lists items in the vault root.
Parameters not published.
obsidian_simple_searchsimple search for documents matching a specified text query across all files in the vault. use this tool when you want to do a simple text search
Parameters not published.
Ask AI
Ask AI about louis030195/easy-obsidian-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
Releases
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.