by Community
Read and write notes, search vault contents, and traverse links in Obsidian through MCP.
npx mcp-server-obsidianAdd the following to your client configuration file.
{
"mcpServers": {
"mcp-server-obsidian": {
"command": "npx",
"args": [
"-y",
"@mcp/mcp-server-obsidian"
]
}
}
}{
"mcpServers": {
"mcp-server-obsidian": {
"command": "npx",
"args": [
"-y",
"@mcp/mcp-server-obsidian"
]
}
}
}{
"mcpServers": {
"mcp-server-obsidian": {
"command": "npx",
"args": [
"-y",
"@mcp/mcp-server-obsidian"
]
}
}
}| Client | Status |
|---|---|
| claude-code | Full Support |
| cursor | Full Support |
| vscode | Full Support |
Run the install command above or copy the configuration snippet for your preferred MCP client.
Add any required API keys or authentication tokens to your MCP client configuration. Check the GitHub README for setup details.
Once configured, the server's tools become available in your AI assistant. You can access features like note reading and writing and vault search.
Obsidian MCP Server is an MCP (Model Context Protocol) server created by Community that allows AI coding assistants to interact with external services and data sources programmatically. Read and write notes, search vault contents, and traverse links in Obsidian through MCP. The server communicates via the stdio transport type and is licensed under MIT.
MCP servers like Obsidian MCP Server extend the capabilities of AI assistants beyond code generation and into real-world integrations. Instead of manually switching between your AI assistant and external tools, the MCP protocol lets the assistant call structured APIs directly — reading data, triggering actions, and maintaining context across interactions. This reduces context switching and allows developers to stay in their IDE or terminal while the assistant handles the integration layer.
With 5 documented capabilities — including note reading and writing, vault search, link traversal — Obsidian MCP Server is one of the more feature-rich MCP servers in its category. With 480 GitHub stars, the project has an active community of contributors and users.
Use Obsidian MCP Server when you want your AI coding assistant to interact with read and write notes, search vault contents, and traverse links in obsidian thro directly from the chat or terminal interface, without manual copy-pasting.
If you find yourself constantly switching between your AI assistant and external tools,Obsidian MCP Server eliminates that friction. The assistant can read context, take actions, and report results — all within a single conversation thread.
MCP servers work well for semi-automated workflows where the AI handles repetitive integration tasks — fetching data, updating records, posting notifications — while you focus on higher-level decisions and code architecture.
Obsidian MCP Server works across 3 compatible clients, including claude-code, cursor, vscode. This means you can use the same server configuration regardless of which AI coding tool your team prefers.
Several MCP servers offer overlapping functionality. The right choice depends on your specific integration needs, the AI clients you use, and your preference for community vs. official support. Here is how Obsidian MCP Server compares:
Google Drive MCP Server by Anthropic is more popular by GitHub stars (18.5K vs 480). Both servers are maintained by different teams — evaluate documentation quality and recent commit activity when choosing.
Brave Search MCP Server by Anthropic is more popular by GitHub stars (18.5K vs 480). Both servers are maintained by different teams — evaluate documentation quality and recent commit activity when choosing.
Notion MCP Server by Notion is more popular by GitHub stars (4.5K vs 480). Both servers are maintained by different teams — evaluate documentation quality and recent commit activity when choosing.
Linear MCP Server by Linear is more popular by GitHub stars (2.8K vs 480). Both servers are maintained by different teams — evaluate documentation quality and recent commit activity when choosing.
Obsidian MCP Server allows AI coding assistants like Claude Code, Cursor, and VS Code Copilot toread and write notes, search vault contents, and traverse links in obsidian through mcp through the Model Context Protocol. Instead of manually performing these actions yourself, the AI assistant invokes server tools directly during your conversation.
Run `npx mcp-server-obsidian` in your terminal, or copy one of the JSON configuration snippets above into your MCP client settings file. Most clients (Claude Desktop, VS Code, Cursor) use a JSON config file — see the Configuration section for client-specific snippets.
Yes, Obsidian MCP Server is free and open source under the MIT license. You can use it, modify it, and contribute to it via the GitHub repository. Note that while the server itself is free, the external services it connects to (such as APIs or cloud platforms) may have their own usage costs.
Obsidian MCP Server has been tested with claude-code, cursor, vscode (full support). Any MCP-compatible client should work, but verify specific tool support in the client's documentation. The compatibility table above shows the latest status.
Share your experience with Obsidian MCP Server and help other developers.