obsidian-mcp-server

MCP server by cyanheads · ★ 695 · updated 7 days ago

Productivity & CommsMaintainedRemote availableOne-click install

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

Install obsidian-mcp-server

Choose your AI client and copy the config.

Add to claude_desktop_config.json — macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Then restart Claude. Setup guide

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OBSIDIAN_API_KEY=your-key",
        "-p",
        "3010:3010",
        "obsidian-mcp-server"
      ]
    }
  }
}

Add to Cursor

Or add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Setup guide

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OBSIDIAN_API_KEY=your-key",
        "-p",
        "3010:3010",
        "obsidian-mcp-server"
      ]
    }
  }
}

Install in VS Code

Or add to .vscode/mcp.json in your workspace. Setup guide

{
  "servers": {
    "obsidian-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OBSIDIAN_API_KEY=your-key",
        "-p",
        "3010:3010",
        "obsidian-mcp-server"
      ]
    }
  }
}

Cascade → Actions → Open MCP config file (often ~/.config/devin/mcp_config.json). Setup guide

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OBSIDIAN_API_KEY=your-key",
        "-p",
        "3010:3010",
        "obsidian-mcp-server"
      ]
    }
  }
}

Run in your terminal: Setup guide

claude mcp add obsidian-mcp-server -- docker run --rm -e OBSIDIAN_API_KEY=your-key -p 3010:3010 obsidian-mcp-server

CLI or add to ~/.codex/config.toml. Setup guide

codex mcp add obsidian-mcp-server -- docker run --rm -e OBSIDIAN_API_KEY=your-key -p 3010:3010 obsidian-mcp-server

[mcp_servers.obsidian-mcp-server]
command = "docker"
args = ["run", "--rm", "-e", "OBSIDIAN_API_KEY=your-key", "-p", "3010:3010", "obsidian-mcp-server"]

Cline panel → Configure MCP Servers, or ~/.cline/data/settings/cline_mcp_settings.json. Setup guide

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OBSIDIAN_API_KEY=your-key",
        "-p",
        "3010:3010",
        "obsidian-mcp-server"
      ]
    }
  }
}

Run the server directly:

docker run --rm -e OBSIDIAN_API_KEY=your-key -p 3010:3010 obsidian-mcp-server

Before you install: Install command taken from the project README. The README mentions API keys or tokens — you'll likely need to add them as environment variables ("env") in the config.

Related Productivity & Comms servers

whatsapp-mcp

by lharries · Go

WhatsApp MCP server

Productivity & CommsStale6.6k

mcp-atlassian

by sooperset · Python

MCP server for Atlassian tools (Confluence, Jira)

Productivity & CommsMaintainedRemote6k

zotero-mcp

by 54yyyu · Python

Zotero MCP: Connects your Zotero research library with Claude and other AI assistants via the Model Context Protocol to discuss papers, get summaries, analyze citations, and more.

Productivity & CommsMaintained5.4k

notion-mcp-server

by makenotion · TypeScript

Official Notion MCP Server

Productivity & CommsMaintainedRemote4.7k

mcp-obsidian

by MarkusPfundstein · Python

MCP server that interacts with Obsidian via the Obsidian rest API community plugin

Productivity & CommsMaintained4.5k

excel-mcp-server

by haris-musa · Python

Excel MCP server: let AI (Claude, Cursor, Codex) create and edit Excel files with charts, PivotTables, slicers and formulas. No Excel required.

Productivity & CommsMaintainedRemote4.2k