Access Obsidian vaults via Local REST API - read, search, and interact with notes
Install
Run one of the commands below, then add the client config underneath.
npx -y @oleksandrkucherenko/mcp-obsidiannpx -y @oleksandrkucherenko/mcp-obsidiandocker run -i --rm ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3docker run -i --rm docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3Client configuration
Paste into Claude Desktop, Cursor (mcp.json), VS Code or any MCP client, then restart the client.
{
"mcpServers": {
"mcp-obsidian-via-rest": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
]
}
}
}About this server
Obsidian Vault MCP Server is listed in the Productivity category of the MCPNav directory. It is distributed as npm, Docker and can be loaded by any client that speaks the Model Context Protocol.
Typical uses include giving your assistant scoped access to the corresponding service so it can answer questions and take actions with real data instead of guessing. Always review what a server can access before you enable it — see our MCP security guide.
Frequently asked questions
What is the Obsidian Vault MCP Server MCP server?＋
Obsidian Vault MCP Server is an MCP server by OleksandrKucherenko. Access Obsidian vaults via Local REST API - read, search, and interact with notes
How do I install Obsidian Vault MCP Server?＋
Install it with: npx -y @oleksandrkucherenko/mcp-obsidian. Then add the JSON config to your client's MCP settings and restart the client.
Is Obsidian Vault MCP Server free to use?＋
The MCP server itself is free to install. The source is public on https://github.com/OleksandrKucherenko/mcp-obsidian-via-rest. Any third-party API it calls (such as a search or maps API) may require its own key and billing.
Which clients support Obsidian Vault MCP Server?＋
Any MCP-compatible client can use it, including Claude Desktop, Cursor, VS Code, Windsurf and custom agents.