Obsidian MCP Server

Install Obsidian MCP Server

Paste this into your MCP client config — Claude Desktop, Claude Code, Cursor, VS Code and Windsurf all read the same shape — then restart the client.

npx -y mcp-obsidian /path/to/vault

Config for each MCP client

The same server, in the shape each client expects. Copy the block for yours, restart it, and Obsidian MCP Server appears in your next session.

Claude Desktop

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

Full Claude Desktop setup guide

Claude Code

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

Full Claude Code setup guide

Cursor

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

Full Cursor setup guide

VS Code

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

Full VS Code setup guide

Windsurf

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

Full Windsurf setup guide

Details

Repository

https://github.com/MarkusPfundstein/mcp-obsidian

Homepage

https://github.com/MarkusPfundstein/mcp-obsidian

Category

Productivity

Stars

2300

Installs per month

19000

Last checked

2026-07-17

Frequently asked questions

How do I install Obsidian MCP Server?

Add it to your MCP client's config with the command `npx -y mcp-obsidian /path/to/vault`, or paste the ready-made JSON block above into Claude Desktop, Cursor, VS Code or Windsurf. Claude Code users can run `claude mcp add obsidian` instead. Restart the client and the tools appear in the next session.

Does Obsidian MCP Server need an API key?

No credential is recorded for this listing, which usually means it runs against something local or public rather than an authenticated API. Check the repository's README before assuming, and if you find otherwise, tell us and we will correct the listing.

Which clients work with Obsidian MCP Server?

Any MCP client. Claude Desktop, Claude Code, Cursor, VS Code with Copilot, Windsurf, Zed, Cline and Continue all speak the Model Context Protocol, so a server written once works in all of them — only the location of the config file differs.

Is Obsidian MCP Server free?

The server itself is free and open source, and you run it yourself. If it connects to a paid third-party API, that service's pricing applies to the calls it makes.

Other Productivity servers

• Notion MCP Server — Read and write pages, databases and comments. Official (Productivity)
• Linear MCP Server — Issues, cycles and projects over MCP. Official (Productivity)