Official server.json
{
"name": "io.github.OleksandrKucherenko/mcp-obsidian-via-rest",
"icons": [
{
"src": "https://raw.githubusercontent.com/OleksandrKucherenko/mcp-obsidian-via-rest/main/docs/obsidian-logo-bw.png",
"sizes": [
"256x256"
],
"mimeType": "image/png"
}
],
"title": "Obsidian Vault MCP Server",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "1.3.3",
"packages": [
{
"version": "1.3.3",
"transport": {
"type": "stdio"
},
"identifier": "@oleksandrkucherenko/mcp-obsidian",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "API_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "Obsidian Local REST API key"
},
{
"name": "API_URLS",
"format": "string",
"isRequired": true,
"description": "JSON array or semicolon-separated list of Obsidian REST API URLs for failover"
},
{
"name": "API_HOST",
"format": "string",
"description": "Obsidian REST API host (legacy single-URL config)"
},
{
"name": "API_PORT",
"format": "number",
"description": "Obsidian REST API port (legacy single-URL config)"
}
]
},
{
"version": "1.3.3",
"transport": {
"url": "http://localhost:{MCP_HTTP_PORT}/mcp",
"type": "streamable-http"
},
"identifier": "@oleksandrkucherenko/mcp-obsidian",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "API_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "Obsidian Local REST API key"
},
{
"name": "API_URLS",
"format": "string",
"isRequired": true,
"description": "JSON array or semicolon-separated list of Obsidian REST API URLs for failover"
},
{
"name": "MCP_TRANSPORTS",
"format": "string",
"default": "stdio,http",
"description": "Enabled transports (default: stdio,http)"
},
{
"name": "MCP_HTTP_PORT",
"format": "number",
"default": "3000",
"description": "HTTP transport bind port (default: 3000)"
},
{
"name": "MCP_HTTP_HOST",
"format": "string",
"description": "HTTP transport bind host (default: 0.0.0.0)"
},
{
"name": "MCP_HTTP_TOKEN",
"format": "string",
"isSecret": true,
"description": "Bearer token for HTTP transport authentication"
}
]
},
{
"transport": {
"url": "http://localhost:{MCP_HTTP_PORT}/mcp",
"type": "streamable-http"
},
"identifier": "ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3",
"runtimeHint": "docker",
"registryType": "oci",
"environmentVariables": [
{
"name": "API_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "Obsidian Local REST API key"
},
{
"name": "API_URLS",
"format": "string",
"isRequired": true,
"description": "JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)"
},
{
"name": "MCP_TRANSPORTS",
"format": "string",
"default": "stdio,http",
"description": "Enabled transports (default: stdio,http)"
},
{
"name": "MCP_HTTP_PORT",
"format": "number",
"default": "3000",
"description": "HTTP transport bind port (default: 3000)"
},
{
"name": "MCP_HTTP_TOKEN",
"format": "string",
"isSecret": true,
"description": "Bearer token for HTTP transport authentication"
}
]
},
{
"transport": {
"url": "http://localhost:{MCP_HTTP_PORT}/mcp",
"type": "streamable-http"
},
"identifier": "docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3",
"runtimeHint": "docker",
"registryType": "oci",
"environmentVariables": [
{
"name": "API_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "Obsidian Local REST API key"
},
{
"name": "API_URLS",
"format": "string",
"isRequired": true,
"description": "JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)"
},
{
"name": "MCP_TRANSPORTS",
"format": "string",
"default": "stdio,http",
"description": "Enabled transports (default: stdio,http)"
},
{
"name": "MCP_HTTP_PORT",
"format": "number",
"default": "3000",
"description": "HTTP transport bind port (default: 3000)"
},
{
"name": "MCP_HTTP_TOKEN",
"format": "string",
"isSecret": true,
"description": "Bearer token for HTTP transport authentication"
}
]
}
],
"repository": {
"url": "https://github.com/OleksandrKucherenko/mcp-obsidian-via-rest",
"source": "github"
},
"websiteUrl": "https://github.com/OleksandrKucherenko/mcp-obsidian-via-rest#readme",
"description": "Access Obsidian vaults via Local REST API - read, search, and interact with notes"
}