mcpbeat Sign in

Obsidian Vault MCP Server

by oleksandrkucherenko Your server? Claim it
local only

Obsidian Vault MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 183 installs a week from npm. Last commit 23 Mar 2026.

Access Obsidian vaults via Local REST API - read, search, and interact with notes

Installs per day peak 50 · avg 27 · +15% w/w
a month agotoday
183
Installs / week
npm · @oleksandrkucherenko/mcp-obsidian
13
Stars
5 open issues
23 Mar 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 18 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs a command on install [пакет] package.json:1
postinstall: bun run build
Runs an external command assets/ci_cleanup_old_screenshots.js:83
  execSync(`bash "${scriptPath}"`, { stdio: "inherit" })
    Object.entries(process.env).filter(([k]) => !excludes.some((e) => k.toLowerCase().includes(e))),

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-obsidian-via-rest -- npx -y @oleksandrkucherenko/mcp-obsidian
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-obsidian-via-rest]
command = "npx"
args = ["-y", "@oleksandrkucherenko/mcp-obsidian"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: API_KEY (Obsidian Local REST API key), API_URLS (JSON array or semicolon-separated list of Obsidian REST API URLs for failover), MCP_TRANSPORTS (Enabled transports (default: stdio,http)), MCP_HTTP_PORT (HTTP transport bind port (default: 3000)), MCP_HTTP_HOST (HTTP transport bind host (default: 0.0.0.0)), MCP_HTTP_TOKEN (Bearer token for HTTP transport authentication). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Obsidian Vault MCP Server

same job, measured the same way
Obsidian MCP Server
by tylern91

Filesystem-based MCP server for Obsidian vaults — read, search, and edit notes, no app required.

local only
Evc Team Relay MCP
by entire-vc

MCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.

158 installs/wk local only
Obsidian MCP Server
by cyanheads

Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

7 553 installs/wk local only
Obsidian Semantic Search
by dalecb

Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.

93 installs/wk local only
Seekstone
by shaqmughal

Filesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.

817 installs/wk local only
Hivemind
by hiveforge-sh

MCP server for Obsidian vaults - AI tools with consistent canonical context. Local-first.

67 installs/wk local only
Stellavault
by evanciel

Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.

103 installs/wk local only
Obsidian Vault MCP
by luffysolution-svg

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.

181 installs/wk local only

Obsidian Vault MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Obsidian Vault MCP Server?
Obsidian Vault MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @oleksandrkucherenko/mcp-obsidian was installed 183 times last week.
How do I connect Obsidian Vault MCP Server?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @oleksandrkucherenko/mcp-obsidian straight from npm; nothing to host, nothing to sign up for.
How many people use Obsidian Vault MCP Server?
The npm package @oleksandrkucherenko/mcp-obsidian was installed 183 times in the last week. Week over week that is +15%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Obsidian Vault MCP Server open source?
Yes — it is published under the MIT licence, written in TypeScript, 13 stars on GitHub and 5 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.