English Français العربية

Easy Obsidian MCP

Community Search and web

Create, read, update and search notes in local Obsidian vaults via filesystem access.

Source code Documentation

What can you do with Easy Obsidian MCP?

  • Open Obsidian → Settings → Community plugins
  • Turn off Restricted mode → Search "Local REST API" → Install & Enable
  • Copy the API key and add to your config:

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Obsidian MCP Server
  2. Quick Start
  3. Other AI Apps
  4. What It Can Do
  5. Example Questions
  6. Troubleshooting

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

Frequently asked questions

What is Easy Obsidian MCP?

Create, read, update and search notes in local Obsidian vaults via filesystem access.

How do I install Easy Obsidian MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Easy Obsidian MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Easy Obsidian MCP?

It is published by louis030195. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.