obsidian-rag-mcp

MCP server for semantic search in your Obsidian notes via Claude Code.

Features

• Semantic search - Find notes by meaning, not just keywords
• Hybrid search - Combines vector search with fuzzy text matching
• Obsidian integration - Returns Obsidian URLs for direct access
• Project filtering - Search within specific projects or folders

Installation

Claude Code

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian-rag": {
      "command": "npx",
      "args": ["obsidian-rag-mcp"],
      "env": {
        "RAG_API_KEY": "rag_your_api_key_here"
      }
    }
  }
}

Get your API key

1. Go to obsidian-rag.matthieucousin.com
2. Log in with your email
3. Go to Settings > API Keys
4. Create a new API key
5. Copy the key (shown only once)

Tools

| Tool | Description | |------|-------------| | rag_search | Semantic search in your knowledge base | | rag_list_projects | List all projects | | rag_list_folders | List indexed folders | | rag_list_categories | List categories | | rag_get_document | Get full document content |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RAG_API_KEY | Yes | Your API key from the webapp | | RAG_API_URL | No | API URL (default: https://obsidian-rag.matthieucousin.com) |

Usage Example

Once configured, you can ask Claude Code:

• "Search my notes for information about React hooks"
• "Find notes related to project management"
• "What did I write about authentication?"

License

MIT