io.github.cyanheads/obsidian-mcp-server

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

io.github.cyanheads/obsidian-mcp-server · Repository · version 3.8.0 · 702 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

npx obsidian-mcp-server

Needs credentials: OBSIDIAN_API_KEY. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
------------------------------------------------------------
 Configuration error — server failed to start
------------------------------------------------------------
@cyanheads/mcp-ts-core requires Node.js >=24.0.0, but this server is running Node.js 22.23.4 (/opt/hostedtoolcache/node/22.23.4/x64/bin/node). Point the client's command at a Node.js 24+ binary, or run the server under Bun >=1.4.4.

Set DEBUG=true for the full stack trace.
------------------------------------------------------------

macOS

needs credentials2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
------------------------------------------------------------
 Configuration error — server failed to start
------------------------------------------------------------
@cyanheads/mcp-ts-core requires Node.js >=24.0.0, but this server is running Node.js 22.23.4 (/Users/runner/hostedtoolcache/node/22.23.4/arm64/bin/node). Point the client's command at a Node.js 24+ binary, or run the server under Bun >=1.4.4.

Set DEBUG=true for the full stack trace.
------------------------------------------------------------

Windows

needs credentials2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
------------------------------------------------------------
 Configuration error — server failed to start
------------------------------------------------------------
@cyanheads/mcp-ts-core requires Node.js >=24.0.0, but this server is running Node.js 22.23.4 (C:\hostedtoolcache\windows\node\22.23.4\x64\node.exe). Point the client's command at a Node.js 24+ binary, or run the server under Bun >=1.4.4.

Set DEBUG=true for the full stack trace.
------------------------------------------------------------

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.cyanheads__obsidian-mcp-server.json)](https://doesitinstall.com/s/io.github.cyanheads__obsidian-mcp-server.html)