Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000",
        "OBSIDIAN_ENABLE_COMMANDS": "false",
        "OBSIDIAN_READ_ONLY": "false",
        "OBSIDIAN_DELETE_ELICITATION": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

claude mcp add obsidian-mcp-server -e "OBSIDIAN_API_KEY=${OBSIDIAN_API_KEY}" -e "OBSIDIAN_BASE_URL=http://127.0.0.1:27123" -e "OBSIDIAN_VERIFY_SSL=false" -e "OBSIDIAN_REQUEST_TIMEOUT_MS=30000" -e "OBSIDIAN_ENABLE_COMMANDS=false" -e "OBSIDIAN_READ_ONLY=false" -e "OBSIDIAN_DELETE_ELICITATION=false" -e "MCP_LOG_LEVEL=info" -- npx -y [email protected]

[mcp_servers.obsidian-mcp-server]
command = "npx"
args = ["-y", "[email protected]"]
env = { "OBSIDIAN_API_KEY" = "${OBSIDIAN_API_KEY}", "OBSIDIAN_BASE_URL" = "http://127.0.0.1:27123", "OBSIDIAN_VERIFY_SSL" = "false", "OBSIDIAN_REQUEST_TIMEOUT_MS" = "30000", "OBSIDIAN_ENABLE_COMMANDS" = "false", "OBSIDIAN_READ_ONLY" = "false", "OBSIDIAN_DELETE_ELICITATION" = "false", "MCP_LOG_LEVEL" = "info" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "obsidian-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "[email protected]"
      ],
      "enabled": true,
      "environment": {
        "OBSIDIAN_API_KEY": "{env:OBSIDIAN_API_KEY}",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000",
        "OBSIDIAN_ENABLE_COMMANDS": "false",
        "OBSIDIAN_READ_ONLY": "false",
        "OBSIDIAN_DELETE_ELICITATION": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000",
        "OBSIDIAN_ENABLE_COMMANDS": "false",
        "OBSIDIAN_READ_ONLY": "false",
        "OBSIDIAN_DELETE_ELICITATION": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=obsidian-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9ic2lkaWFuLW1jcC1zZXJ2ZXJAMy43LjAiXSwiZW52Ijp7Ik9CU0lESUFOX0FQSV9LRVkiOiIke09CU0lESUFOX0FQSV9LRVl9IiwiT0JTSURJQU5fQkFTRV9VUkwiOiJodHRwOi8vMTI3LjAuMC4xOjI3MTIzIiwiT0JTSURJQU5fVkVSSUZZX1NTTCI6ImZhbHNlIiwiT0JTSURJQU5fUkVRVUVTVF9USU1FT1VUX01TIjoiMzAwMDAiLCJPQlNJRElBTl9FTkFCTEVfQ09NTUFORFMiOiJmYWxzZSIsIk9CU0lESUFOX1JFQURfT05MWSI6ImZhbHNlIiwiT0JTSURJQU5fREVMRVRFX0VMSUNJVEFUSU9OIjoiZmFsc2UiLCJNQ1BfTE9HX0xFVkVMIjoiaW5mbyJ9fQ%3D%3D"
}

{
  "servers": {
    "obsidian-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000",
        "OBSIDIAN_ENABLE_COMMANDS": "false",
        "OBSIDIAN_READ_ONLY": "false",
        "OBSIDIAN_DELETE_ELICITATION": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000",
        "OBSIDIAN_ENABLE_COMMANDS": "false",
        "OBSIDIAN_READ_ONLY": "false",
        "OBSIDIAN_DELETE_ELICITATION": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

extensions:
  "obsidian-mcp-server":
    enabled: true
    name: "obsidian-mcp-server"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "[email protected]"
    envs:
      "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}"
      "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      "OBSIDIAN_VERIFY_SSL": "false"
      "OBSIDIAN_REQUEST_TIMEOUT_MS": "30000"
      "OBSIDIAN_ENABLE_COMMANDS": "false"
      "OBSIDIAN_READ_ONLY": "false"
      "OBSIDIAN_DELETE_ELICITATION": "false"
      "MCP_LOG_LEVEL": "info"
    timeout: 300

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected], [email protected]

Tool list unknown · checked 2026-10-20 13:49 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80

livenessn/a

freshness100

hygiene100

+repository +namespace-matches-repo ~liveness-unmeasured +updated-14d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`obsidian-mcp-server`	npm	3.7.0	npx
`obsidian-mcp-server`	npm	3.7.0	npx

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

More from io.github.cyanheads

And 140 more from this publisher.

Official server.json

{
  "name": "io.github.cyanheads/obsidian-mcp-server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "3.7.0",
  "packages": [
    {
      "version": "3.7.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "obsidian-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "OBSIDIAN_API_KEY",
          "format": "string",
          "isRequired": true,
          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API)."
        },
        {
          "name": "OBSIDIAN_BASE_URL",
          "format": "string",
          "default": "http://127.0.0.1:27123",
          "description": "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)."
        },
        {
          "name": "OBSIDIAN_VERIFY_SSL",
          "format": "string",
          "default": "false",
          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert."
        },
        {
          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
          "format": "string",
          "default": "30000",
          "description": "Per-request timeout in milliseconds."
        },
        {
          "name": "OBSIDIAN_ENABLE_COMMANDS",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_READ_PATHS",
          "format": "string",
          "description": "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/'."
        },
        {
          "name": "OBSIDIAN_WRITE_PATHS",
          "format": "string",
          "description": "Optional comma-separated vault-relative folder allowlist for writes. Same syntax as OBSIDIAN_READ_PATHS. Unset = full vault. Example: 'projects/,scratch/'."
        },
        {
          "name": "OBSIDIAN_READ_ONLY",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_DELETE_ELICITATION",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_OMNISEARCH_URL",
          "format": "string",
          "description": "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."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    },
    {
      "version": "3.7.0",
      "transport": {
        "url": "http://localhost:3010/mcp",
        "type": "streamable-http"
      },
      "identifier": "obsidian-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "MCP_TRANSPORT_TYPE",
          "value": "http",
          "format": "string",
          "description": "Selects the HTTP transport."
        },
        {
          "name": "OBSIDIAN_API_KEY",
          "format": "string",
          "isRequired": true,
          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API)."
        },
        {
          "name": "OBSIDIAN_BASE_URL",
          "format": "string",
          "default": "http://127.0.0.1:27123",
          "description": "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)."
        },
        {
          "name": "OBSIDIAN_VERIFY_SSL",
          "format": "string",
          "default": "false",
          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert."
        },
        {
          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
          "format": "string",
          "default": "30000",
          "description": "Per-request timeout in milliseconds."
        },
        {
          "name": "OBSIDIAN_ENABLE_COMMANDS",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_READ_PATHS",
          "format": "string",
          "description": "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/'."
        },
        {
          "name": "OBSIDIAN_WRITE_PATHS",
          "format": "string",
          "description": "Optional comma-separated vault-relative folder allowlist for writes. Same syntax as OBSIDIAN_READ_PATHS. Unset = full vault. Example: 'projects/,scratch/'."
        },
        {
          "name": "OBSIDIAN_READ_ONLY",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_DELETE_ELICITATION",
          "format": "string",
          "default": "false",
          "description": "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."
        },
        {
          "name": "OBSIDIAN_OMNISEARCH_URL",
          "format": "string",
          "description": "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."
        },
        {
          "name": "MCP_HTTP_HOST",
          "format": "string",
          "default": "127.0.0.1",
          "description": "The hostname for the HTTP server."
        },
        {
          "name": "MCP_HTTP_PORT",
          "format": "string",
          "default": "3010",
          "description": "The port to run the HTTP server on."
        },
        {
          "name": "MCP_HTTP_ENDPOINT_PATH",
          "format": "string",
          "default": "/mcp",
          "description": "The endpoint path for the MCP server."
        },
        {
          "name": "MCP_AUTH_MODE",
          "format": "string",
          "default": "none",
          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/cyanheads/obsidian-mcp-server",
    "source": "github"
  },
  "description": "Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP."
}