
Obsidian Vault MCP Server
Access Obsidian vaults via Local REST API - read, search, and interact with notes
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 1.3.3
- Listing updated
- 4 days ago
About Obsidian Vault MCP Server
Obsidian Vault MCP Server is an open-source MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidianAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-obsidian-via-rest": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-obsidian-via-rest": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-obsidian-via-rest": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-obsidian-via-rest": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-obsidian-via-rest": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>"
}
}
}
}Configuration
API_KEYObsidian Local REST API keyRequiredAPI_URLSJSON array or semicolon-separated list of Obsidian REST API URLs for failoverRequiredAPI_HOSTObsidian REST API host (legacy single-URL config)API_PORTObsidian REST API port (legacy single-URL config)API_KEYObsidian Local REST API keyRequiredAPI_URLSJSON array or semicolon-separated list of Obsidian REST API URLs for failoverRequiredMCP_TRANSPORTSEnabled transports (default: stdio,http)MCP_HTTP_PORTHTTP transport bind port (default: 3000)MCP_HTTP_HOSTHTTP transport bind host (default: 0.0.0.0)MCP_HTTP_TOKENBearer token for HTTP transport authenticationAPI_KEYObsidian Local REST API keyRequiredAPI_URLSJSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)RequiredMCP_TRANSPORTSEnabled transports (default: stdio,http)MCP_HTTP_PORTHTTP transport bind port (default: 3000)MCP_HTTP_TOKENBearer token for HTTP transport authenticationAPI_KEYObsidian Local REST API keyRequiredAPI_URLSJSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)RequiredMCP_TRANSPORTSEnabled transports (default: stdio,http)MCP_HTTP_PORTHTTP transport bind port (default: 3000)MCP_HTTP_TOKENBearer token for HTTP transport authentication
Pricing
Open source
Obsidian Vault MCP Server FAQ
Is Obsidian Vault MCP Server free?
Yes. Obsidian Vault MCP Server is open source, so you can use and self-host it for free.
How do I add Obsidian Vault MCP Server to Claude Code?
Run this command in your terminal: claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidian
What are the best alternatives to Obsidian Vault MCP Server?
The closest alternatives to Obsidian Vault MCP Server are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.
Alternatives to Obsidian Vault MCP Server

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools