Obsidian MCP Server

by cyanheadsio.github.cyanheads/obsidian-mcp-serverv3.7.0

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

693Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Obsidian MCP server

claude mcp add obsidian-cyanheads -e OBSIDIAN_API_KEY='<obsidian-api-key>' -- npx -y obsidian-mcp-server

{
  "mcpServers": {
    "obsidian-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<obsidian-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "obsidian-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<obsidian-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "obsidian-cyanheads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<obsidian-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "obsidian-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<obsidian-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OBSIDIAN_API_KEY	yes	—	Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).
OBSIDIAN_BASE_URL	—	—	Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable "Non-encrypted (HTTP) Server" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).
OBSIDIAN_VERIFY_SSL	—	—	Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.
OBSIDIAN_REQUEST_TIMEOUT_MS	—	—	Per-request timeout in milliseconds.
OBSIDIAN_ENABLE_COMMANDS	—	—	Opt-in flag for the command-palette pair (obsidian_list_commands + obsidian_execute_command). Off by default — Obsidian commands are opaque and can be destructive.
OBSIDIAN_READ_PATHS	—	—	Optional comma-separated vault-relative folder allowlist for reads. Prefix-based with implicit recursion; case-insensitive; trailing slashes normalized. Unset = full vault. Write paths are implicitly readable. Example: 'public/,projects/'.
OBSIDIAN_WRITE_PATHS	—	—	Optional comma-separated vault-relative folder allowlist for writes. Same syntax as OBSIDIAN_READ_PATHS. Unset = full vault. Example: 'projects/,scratch/'.
OBSIDIAN_READ_ONLY	—	—	Global read-only kill switch. When true, every write is denied regardless of OBSIDIAN_WRITE_PATHS, and the command-palette pair is suppressed (commands can mutate). Useful for shared or public-facing deployments.
OBSIDIAN_DELETE_ELICITATION	—	—	Opt-in delete confirmation. When true, obsidian_delete_note asks the user to confirm each delete through an elicitation round (the client must support elicitation), and HTTP startup requires a stateful session unless OBSIDIAN_READ_ONLY=true disables the tool. Off by default — the delete runs on the first call, bounded by OBSIDIAN_WRITE_PATHS and OBSIDIAN_READ_ONLY.
OBSIDIAN_OMNISEARCH_URL	—	—	Override URL for the Omnisearch plugin HTTP server. Unset derives from OBSIDIAN_BASE_URL host with port 51361. Required only if the Omnisearch plugin is not on the default port.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPE	—	—	Selects the HTTP transport.
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
2026-10-06 · 4d ago · GitHub · v3.7.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 4d ago · official registry · v3.7.0

FAQ

›How do I install the Obsidian MCP server in Claude Code?

Run: claude mcp add obsidian-cyanheads -e OBSIDIAN_API_KEY='<obsidian-api-key>' -- npx -y obsidian-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Obsidian require an API key?

Yes. It expects OBSIDIAN_API_KEY.

›Can I use Obsidian as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Obsidian in the official MCP registry?

Yes, as io.github.cyanheads/obsidian-mcp-server.