obsidian-mcp-server

obsidian-mcp-server is a local MCP server: Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. Install it from npm as obsidian-mcp-server.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add obsidian-mcp-server -e OBSIDIAN_API_KEY=... -e OBSIDIAN_BASE_URL=... -e OBSIDIAN_VERIFY_SSL=... -e OBSIDIAN_REQUEST_TIMEOUT_MS=... -e OBSIDIAN_ENABLE_COMMANDS=... -e OBSIDIAN_READ_PATHS=... -e OBSIDIAN_WRITE_PATHS=... -e OBSIDIAN_READ_ONLY=... -e OBSIDIAN_OMNISEARCH_URL=... -e MCP_LOG_LEVEL=... -- npx -y obsidian-mcp-server

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "...",
        "OBSIDIAN_BASE_URL": "...",
        "OBSIDIAN_VERIFY_SSL": "...",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "...",
        "OBSIDIAN_ENABLE_COMMANDS": "...",
        "OBSIDIAN_READ_PATHS": "...",
        "OBSIDIAN_WRITE_PATHS": "...",
        "OBSIDIAN_READ_ONLY": "...",
        "OBSIDIAN_OMNISEARCH_URL": "...",
        "MCP_LOG_LEVEL": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx) or Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, OBSIDIAN_VERIFY_SSL, OBSIDIAN_REQUEST_TIMEOUT_MS, OBSIDIAN_ENABLE_COMMANDS, OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS, OBSIDIAN_READ_ONLY, OBSIDIAN_OMNISEARCH_URL, MCP_LOG_LEVEL, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE