AI Plugin Index
Obsidian Vault MCP Server
CommunityMCP server by OleksandrKucherenko · updated · ★ 13 · 59 downloads a week
Access Obsidian vaults via Local REST API - read, search, and interact with notes Obsidian Vault MCP Server is a community project by OleksandrKucherenko, not verified by a company domain.
Install Obsidian Vault MCP Server
Built from the published package, never by AIclaude mcp add obsidian-vault-mcp-server -e API_KEY=YOUR_API_KEY -e API_URLS=YOUR_API_URLS -- npx -y @oleksandrkucherenko/mcp-obsidianRun in your terminal. Add --scope user to use it in every project.
Step-by-step: install Obsidian Vault MCP Server in Claude Code
{
"mcpServers": {
"obsidian-vault-mcp-server": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "YOUR_API_KEY",
"API_URLS": "YOUR_API_URLS"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
Step-by-step: install Obsidian Vault MCP Server in Claude Desktop
{
"mcpServers": {
"obsidian-vault-mcp-server": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "YOUR_API_KEY",
"API_URLS": "YOUR_API_URLS"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"obsidian-vault-mcp-server": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "YOUR_API_KEY",
"API_URLS": "YOUR_API_URLS"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add obsidian-vault-mcp-server --env API_KEY=YOUR_API_KEY --env API_URLS=YOUR_API_URLS -- npx -y @oleksandrkucherenko/mcp-obsidian{
"mcpServers": {
"obsidian-vault-mcp-server": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "YOUR_API_KEY",
"API_URLS": "YOUR_API_URLS"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install Obsidian Vault MCP Server in Antigravity CLI
gemini mcp add obsidian-vault-mcp-server npx -y @oleksandrkucherenko/mcp-obsidianGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
Step-by-step: install Obsidian Vault MCP Server in Gemini CLI
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the obsidian-vault-mcp-server block.
Last commit 202 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
API_Environment variable, secret | Required | Obsidian Local REST API key |
API_Environment variable | Required | JSON array or semicolon-separated list of Obsidian REST API URLs for failover |
API_Environment variable | Optional | Obsidian REST API host (legacy single-URL config) |
API_Environment variable | Optional | Obsidian REST API port (legacy single-URL config) |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like Obsidian Vault MCP Server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to Obsidian Vault MCP Server
All alternatives →
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Search, read, annotate, and add to your Zotero research library, local or web.
Digital asset manager - upload, organize, search, and generate on-brand images and videos
Obsidian Vault MCP Server: common questions
How do I install Obsidian Vault MCP Server?
In Claude Code run claude mcp add obsidian-vault-mcp-server -e API_KEY=YOUR_API_KEY -e API_URLS=YOUR_API_URLS -- npx -y @oleksandrkucherenko/mcp-obsidian. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Obsidian Vault MCP Server the official server?
Obsidian Vault MCP Server is a community project by OleksandrKucherenko, not verified by a company domain.
Is Obsidian Vault MCP Server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Obsidian Vault MCP Server safe to use?
It scores 53 of 100. Grades: maintenance D, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to Obsidian Vault MCP Server?
Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.
Does Obsidian Vault MCP Server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.