Obsidian
Enables Claude Code and Claude Desktop to interact with Obsidian vaults through MCP protocol. Supports file operations, workspace context access, and dual transport (WebSocket and HTTP/SSE) for AI-powered assistance with your notes.
What is Obsidian?
Obsidian is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables claude code and claude desktop to interact with obsidian vaults through mcp protocol. supports file operations, workspace context access, and dual transport (websocket and http/sse) for ai-pow...
Enables Claude Code and Claude Desktop to interact with Obsidian vaults through MCP protocol. Supports file operations, workspace context access, and dual transport (WebSocket and HTTP/SSE) for AI-powered assistance with your notes.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables Claude Code and Claude Desktop to interact with Obsi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx obsidian-claude-code-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Obsidian
The Obsidian Claude Code MCP server is an Obsidian community plugin that exposes your Obsidian vault to Claude Code and Claude Desktop via the Model Context Protocol, enabling AI-powered file operations, note search, workspace inspection, and vault management through natural language. It runs an HTTP/SSE server inside Obsidian on a configurable port and supports both direct HTTP connections (for MCP clients with native SSE support) and mcp-remote bridge connections (for Claude Desktop). Obsidian users who want to use Claude as an intelligent note-taking assistant or knowledge base navigator will find this the most direct integration available.
Prerequisites
- Obsidian installed with Community Plugins enabled
- Node.js and npx available for Claude Desktop integration via mcp-remote
- Claude Desktop or Claude Code as your MCP client
- The Obsidian Claude Code plugin installed and enabled from Community Plugins
Install the plugin from Obsidian Community Plugins
Open Obsidian Settings → Community Plugins → Browse, search for 'Claude Code', and install the plugin. Enable it after installation.
Note the HTTP server port
After enabling the plugin, go to Settings → Community Plugins → Claude Code → Settings to view or change the HTTP server port. The default is 22360.
Configure Claude Desktop with mcp-remote
Claude Desktop does not natively support SSE transport, so use npx mcp-remote as a bridge. Add this to your claude_desktop_config.json.
Configure Claude Code using the /ide command
In Claude Code, run the /ide command and select 'Obsidian' from the IDE list. Claude Code supports the SSE transport natively and connects directly to the plugin's HTTP server.
Test the connection
Ask Claude 'What files are in my Obsidian vault?' to verify that the MCP server is connected and file listing is working.
Obsidian Examples
Client configuration (Claude Desktop via mcp-remote)
Claude Desktop config using npx mcp-remote to bridge the SSE connection to the Obsidian plugin's HTTP server.
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:22360/sse"
]
}
}
}Client configuration (native SSE client)
For MCP clients that support SSE transport natively (Claude Code and others), connect directly with the URL.
{
"mcpServers": {
"obsidian": {
"url": "http://localhost:22360/sse"
}
}
}Prompts to try
Example prompts to read, search, edit, and organize notes in your Obsidian vault via Claude.
- "What files are in my Obsidian vault?"
- "Read my note called 'Project Roadmap' and summarize the key milestones"
- "Create a new note called 'Meeting Notes 2025-06-13' with today's agenda"
- "Find all notes that mention 'authentication' and list their titles"
- "Update the 'TODO' note and add a new task: review the API design document"Troubleshooting Obsidian
Claude Desktop cannot connect: 'Connection refused' on port 22360
Ensure the Obsidian Claude Code plugin is enabled and Obsidian is running. The HTTP server only runs while Obsidian is open. Check Settings → Community Plugins → Claude Code to confirm the plugin is active.
npx mcp-remote fails with 'module not found'
Run npm install -g mcp-remote to install the bridge globally, or update npx by upgrading Node.js. Ensure npx is in your PATH by running: which npx.
Running multiple Obsidian vaults causes port conflicts
Change the HTTP server port in Settings → Community Plugins → Claude Code → Settings for each vault instance to a unique port (e.g., 22360, 22361). Update your MCP client config to match the correct port for each vault.
Frequently Asked Questions about Obsidian
What is Obsidian?
Obsidian is a Model Context Protocol (MCP) server that enables claude code and claude desktop to interact with obsidian vaults through mcp protocol. supports file operations, workspace context access, and dual transport (websocket and http/sse) for ai-powered assistance with your notes. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Obsidian?
Follow the installation instructions on the Obsidian GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Obsidian?
Obsidian works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Obsidian free to use?
Yes, Obsidian is open source and available under the BSD Zero Clause License license. You can use it freely in both personal and commercial projects.
Obsidian Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Obsidian? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Obsidian in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Obsidian?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.