louis030195/easy-obsidian-mcp
FreeNot checkedCreate, read, update and search notes in local Obsidian vaults via filesystem access.
About
Create, read, update and search notes in local Obsidian vaults via 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
Installing louis030195/easy-obsidian-mcp
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/louis030195/easy-obsidian-mcpFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare 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
