Query and search Obsidian vaults via a local REST API, enabling Claude to read notes, retrieve metadata, and interact with your vault without leaving the chat. Built for developers who want to integrate Obsidian into AI workflows.
io.github.OleksandrKucherenko/mcp-obsidian-via-rest
Local install
STDIO
8 required env vars
How models use it and what it is built for.
Query and search Obsidian vaults via a local REST API, enabling Claude to read notes, retrieve metadata, and interact with your vault without leaving the chat. Built for developers who want to integrate Obsidian into AI workflows.
Local install — runs as a subprocess.
Configuration this server reads at startup.
Obsidian Local REST API key
JSON array or semicolon-separated list of Obsidian REST API URLs for failover
Obsidian Local REST API key
JSON array or semicolon-separated list of Obsidian REST API URLs for failover
Obsidian Local REST API key
JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)
Obsidian Local REST API key
JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)
Obsidian REST API host (legacy single-URL config)
Obsidian REST API port (legacy single-URL config)
Enabled transports (default: stdio,http)
HTTP transport bind port (default: 3000)
HTTP transport bind host (default: 0.0.0.0)
Bearer token for HTTP transport authentication
Enabled transports (default: stdio,http)
HTTP transport bind port (default: 3000)
Bearer token for HTTP transport authentication
Enabled transports (default: stdio,http)
HTTP transport bind port (default: 3000)
Bearer token for HTTP transport authentication
Where to find authoritative docs and source for Obsidian Vault.
Paste any of these into Agent Studio after connecting Obsidian Vault.
Common questions about connecting and running Obsidian Vault.
What do I need to set up this MCP server?
You need Obsidian running with the Local REST API plugin enabled, an API key from that plugin, and the API URL(s) configured via the API_URLS environment variable (or legacy API_HOST/API_PORT). The server supports failover by accepting multiple URLs as a JSON array or semicolon-separated list.
Can I use this with multiple Obsidian vaults?
Yes. Set the API_URLS environment variable to a JSON array or semicolon-separated list of REST API endpoints, and the server will support failover across multiple vaults or instances.
Does this server support HTTP transport?
Yes. By default, both stdio and HTTP transports are enabled. You can configure the HTTP port (default 3000), host (default 0.0.0.0), and optionally set a Bearer token via MCP_HTTP_TOKEN for authentication.
Is my Obsidian data sent to Anthropic or a remote server?
No. This server communicates only with your local Obsidian REST API instance. All queries and data remain on your machine—nothing is sent to external services.
What happens if one API URL fails in a failover setup?
The server will automatically try the next URL in the API_URLS list. This allows you to configure multiple Obsidian instances or backup endpoints for high availability.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 40+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent StudioJudges Panel
45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.
Addozhang Nexus
Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts
Cyanheads MCP Ts Template
TypeScript template for building MCP servers with declarative tooling, observability, and auth.
Chernistry Bernstein
Declarative agent orchestration for engineering teams