Obsidian MCP (StevenStavrakis)

Reads, searches and edits notes directly in an Obsidian vault folder, no plugin needed. Needs Node 22+.

🗂️ Team productivity742Updated 2026-10-08By StevenStavrakisLicense: MITAuth: NoneGitHub ↗

Found viaWebnpm: obsidian-mcp GitHubGitHub: StevenStavrakis/obsidian-mcp (★ 742 on 2026-10-15)

Test results

Last passed 2026-10-15

Claude CodePassed2026-10-15 · install, connect, tools, agent task

CursorPassed2026-10-15 · install, connect, tools, agent task

Claude DesktopNot tested yet—

ChatGPT (Codex)Not tested yet—

Full result per app: Does it work with Claude Code? · Does it work with Cursor?

Protocol: starts, 12 tools listed · 2026-10-15

🧪 Test-box note: Requires Node 22+ (the server refuses Node 20). Box system Node is 20.19.2; harness runs it with a user-local Node 22 (~/opt/node22). Published snippet uses plain npx.

Install

claude mcp add obsidian-mcp -- npx -y obsidian-mcp /path/to/dir/vault

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/path/to/dir/vault"
      ]
    }
  }
}

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/path/to/dir/vault"
      ]
    }
  }
}

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.obsidian-mcp]
command = "npx"
args = ["-y", "obsidian-mcp", "/path/to/dir/vault"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-15	Protocol (direct stdio)	Protocol: starts, 12 tools listed	2.0.1
2026-10-15	Claude Code	Passed install, connect, tools, agent task	2.1.296 (Claude Code)
2026-10-15	Cursor	Passed install, connect, tools, agent task	2026.10.12-d47ca18

Tools seen by our harness (12)

obsidian_list_vaultsobsidian_read_noteobsidian_create_noteobsidian_edit_noteobsidian_delete_noteobsidian_move_noteobsidian_create_directoryobsidian_search_vaultobsidian_add_tagsobsidian_remove_tagsobsidian_rename_tagobsidian_manage_tags