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?

• GitHub Issues

• Support this project

Made with ❤️ for the Obsidian community