Loading…
Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.
io.github.cyanheads/obsidian-mcp-server is an MCP server entry in ChatHome Skills, sourced from Official MCP Registry and scored 78/100. As a Model Context Protocol server, it exposes tools that MCP-compatible LLM clients such as Claude, Cursor, and Copilot can call directly, extending an agent's reach beyond its built-in capabilities. ChatHome Skills discovered this entry through its daily ingest of official registries and GitHub discovery queries, and re-verifies repository facts, freshness signals, and install metadata on every run. The quality score weighs official-registry presence, a working install command, license clarity, GitHub star trajectory, and repository freshness — the full formula is on the Sources page. The install command above is ready to copy. Review the last-pushed date and repository status before adding io.github.cyanheads/obsidian-mcp-server to a production agent workflow; the snapshot facts below are point-in-time values from the most recent ingest.
npx -y obsidian-mcp-server@3.7.2Review the upstream source before running this command.
{
"_meta": {
"io.modelcontextprotocol.registry/official": {
"status": "active",
"isLatest": true,
"updatedAt": "2026-10-26T04:03:09.920406Z",
"publishedAt": "2026-10-26T04:03:09.920406Z",
"statusChangedAt": "2026-10-26T04:03:09.920406Z"
}
},
"server": {
"name": "io.github.cyanheads/obsidian-mcp-server",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "3.7.2",
"packages": [
{
"version": "3.7.2",
"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, or the read scope when reads are restricted. 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.2",
"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, or the read scope when reads are restricted. 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."
}
}