Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VAULT_PATH",
        "-e",
        "SECRET_KEY",
        "-e",
        "MCP_HOSTNAME",
        "-e",
        "EMBEDDING_PROVIDER",
        "-e",
        "OLLAMA_URL",
        "-e",
        "OPENAI_API_KEY",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "VAULT_PATH": "/obsidian",
        "SECRET_KEY": "${SECRET_KEY}",
        "MCP_HOSTNAME": "${MCP_HOSTNAME}",
        "EMBEDDING_PROVIDER": "ollama",
        "OLLAMA_URL": "http://ollama:11434",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  }
}

claude mcp add obsidian-mcp -e "DATABASE_URL=${DATABASE_URL}" -e "VAULT_PATH=/obsidian" -e "SECRET_KEY=${SECRET_KEY}" -e "MCP_HOSTNAME=${MCP_HOSTNAME}" -e "EMBEDDING_PROVIDER=ollama" -e "OLLAMA_URL=http://ollama:11434" -e "OPENAI_API_KEY=${OPENAI_API_KEY}" -- docker run -i --rm -e DATABASE_URL -e VAULT_PATH -e SECRET_KEY -e MCP_HOSTNAME -e EMBEDDING_PROVIDER -e OLLAMA_URL -e OPENAI_API_KEY ghcr.io/maxkuminov/obsidian-mcp:v1.1.0

[mcp_servers.obsidian-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "DATABASE_URL", "-e", "VAULT_PATH", "-e", "SECRET_KEY", "-e", "MCP_HOSTNAME", "-e", "EMBEDDING_PROVIDER", "-e", "OLLAMA_URL", "-e", "OPENAI_API_KEY", "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"]
env = { "DATABASE_URL" = "${DATABASE_URL}", "VAULT_PATH" = "/obsidian", "SECRET_KEY" = "${SECRET_KEY}", "MCP_HOSTNAME" = "${MCP_HOSTNAME}", "EMBEDDING_PROVIDER" = "ollama", "OLLAMA_URL" = "http://ollama:11434", "OPENAI_API_KEY" = "${OPENAI_API_KEY}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "obsidian-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VAULT_PATH",
        "-e",
        "SECRET_KEY",
        "-e",
        "MCP_HOSTNAME",
        "-e",
        "EMBEDDING_PROVIDER",
        "-e",
        "OLLAMA_URL",
        "-e",
        "OPENAI_API_KEY",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
      ],
      "enabled": true,
      "environment": {
        "DATABASE_URL": "{env:DATABASE_URL}",
        "VAULT_PATH": "/obsidian",
        "SECRET_KEY": "{env:SECRET_KEY}",
        "MCP_HOSTNAME": "{env:MCP_HOSTNAME}",
        "EMBEDDING_PROVIDER": "ollama",
        "OLLAMA_URL": "http://ollama:11434",
        "OPENAI_API_KEY": "{env:OPENAI_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VAULT_PATH",
        "-e",
        "SECRET_KEY",
        "-e",
        "MCP_HOSTNAME",
        "-e",
        "EMBEDDING_PROVIDER",
        "-e",
        "OLLAMA_URL",
        "-e",
        "OPENAI_API_KEY",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "VAULT_PATH": "/obsidian",
        "SECRET_KEY": "${SECRET_KEY}",
        "MCP_HOSTNAME": "${MCP_HOSTNAME}",
        "EMBEDDING_PROVIDER": "ollama",
        "OLLAMA_URL": "http://ollama:11434",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=obsidian-mcp&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIkRBVEFCQVNFX1VSTCIsIi1lIiwiVkFVTFRfUEFUSCIsIi1lIiwiU0VDUkVUX0tFWSIsIi1lIiwiTUNQX0hPU1ROQU1FIiwiLWUiLCJFTUJFRERJTkdfUFJPVklERVIiLCItZSIsIk9MTEFNQV9VUkwiLCItZSIsIk9QRU5BSV9BUElfS0VZIiwiZ2hjci5pby9tYXhrdW1pbm92L29ic2lkaWFuLW1jcDp2MS4xLjAiXSwiZW52Ijp7IkRBVEFCQVNFX1VSTCI6IiR7REFUQUJBU0VfVVJMfSIsIlZBVUxUX1BBVEgiOiIvb2JzaWRpYW4iLCJTRUNSRVRfS0VZIjoiJHtTRUNSRVRfS0VZfSIsIk1DUF9IT1NUTkFNRSI6IiR7TUNQX0hPU1ROQU1FfSIsIkVNQkVERElOR19QUk9WSURFUiI6Im9sbGFtYSIsIk9MTEFNQV9VUkwiOiJodHRwOi8vb2xsYW1hOjExNDM0IiwiT1BFTkFJX0FQSV9LRVkiOiIke09QRU5BSV9BUElfS0VZfSJ9fQ%3D%3D"
}

{
  "servers": {
    "obsidian-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VAULT_PATH",
        "-e",
        "SECRET_KEY",
        "-e",
        "MCP_HOSTNAME",
        "-e",
        "EMBEDDING_PROVIDER",
        "-e",
        "OLLAMA_URL",
        "-e",
        "OPENAI_API_KEY",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "VAULT_PATH": "/obsidian",
        "SECRET_KEY": "${SECRET_KEY}",
        "MCP_HOSTNAME": "${MCP_HOSTNAME}",
        "EMBEDDING_PROVIDER": "ollama",
        "OLLAMA_URL": "http://ollama:11434",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VAULT_PATH",
        "-e",
        "SECRET_KEY",
        "-e",
        "MCP_HOSTNAME",
        "-e",
        "EMBEDDING_PROVIDER",
        "-e",
        "OLLAMA_URL",
        "-e",
        "OPENAI_API_KEY",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "VAULT_PATH": "/obsidian",
        "SECRET_KEY": "${SECRET_KEY}",
        "MCP_HOSTNAME": "${MCP_HOSTNAME}",
        "EMBEDDING_PROVIDER": "ollama",
        "OLLAMA_URL": "http://ollama:11434",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  }
}

extensions:
  "obsidian-mcp":
    enabled: true
    name: "obsidian-mcp"
    type: stdio
    cmd: "docker"
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "DATABASE_URL"
      - "-e"
      - "VAULT_PATH"
      - "-e"
      - "SECRET_KEY"
      - "-e"
      - "MCP_HOSTNAME"
      - "-e"
      - "EMBEDDING_PROVIDER"
      - "-e"
      - "OLLAMA_URL"
      - "-e"
      - "OPENAI_API_KEY"
      - "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0"
    envs:
      "DATABASE_URL": "${DATABASE_URL}"
      "VAULT_PATH": "/obsidian"
      "SECRET_KEY": "${SECRET_KEY}"
      "MCP_HOSTNAME": "${MCP_HOSTNAME}"
      "EMBEDDING_PROVIDER": "ollama"
      "OLLAMA_URL": "http://ollama:11434"
      "OPENAI_API_KEY": "${OPENAI_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${DATABASE_URL}, ${SECRET_KEY}, ${OPENAI_API_KEY}. The registry never accepts secret values.

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.resolvableno npm or PyPI package

Tool list unknown · checked 2026-11-07 20:18 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 94 / 100

provenance90

livenessn/a

freshness100

hygiene95

+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-2d-ago -unpinned-packages(1)

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

Endpoints

package	registry	version	runtime	secrets
`ghcr.io/maxkuminov/obsidian-mcp:v1.1.0`	oci	unpinned	–	`DATABASE_URL`, `SECRET_KEY`, `OPENAI_API_KEY`

Tools (0)

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

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.maxkuminov/obsidian-mcp",
  "title": "Obsidian MCP Server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.1.0",
  "packages": [
    {
      "transport": {
        "url": "http://localhost:8000/mcp",
        "type": "streamable-http"
      },
      "identifier": "ghcr.io/maxkuminov/obsidian-mcp:v1.1.0",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "DATABASE_URL",
          "isSecret": true,
          "isRequired": true,
          "description": "PostgreSQL 16 + pgvector (0.8.0+) connection URL for the app's NON-superuser role, e.g. postgresql+asyncpg://obsidian_mcp:<password>@postgres:5432/obsidian_mcp. A superuser role or a CHANGE_ME password is refused at startup."
        },
        {
          "name": "VAULT_PATH",
          "format": "filepath",
          "default": "/obsidian",
          "isRequired": true,
          "description": "Path of the Obsidian vault inside the container (mount your vault read-write there)."
        },
        {
          "name": "SECRET_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "itsdangerous signer for cookies/sessions. Generate with `openssl rand -hex 32`; the app refuses to start on a placeholder."
        },
        {
          "name": "MCP_HOSTNAME",
          "isRequired": true,
          "description": "Public hostname your reverse proxy routes to. Also derives BASE_URL, ALLOWED_ORIGINS and ALLOWED_HOSTS as https://<MCP_HOSTNAME> unless those are set explicitly.",
          "placeholder": "obsidian-mcp.example.com"
        },
        {
          "name": "EMBEDDING_PROVIDER",
          "choices": [
            "ollama",
            "openai"
          ],
          "default": "ollama",
          "description": "Embedding provider: `ollama` (self-hosted, default) or `openai` (bring your own key). Switching after deploy requires `make reset-embeddings`."
        },
        {
          "name": "OLLAMA_URL",
          "default": "http://ollama:11434",
          "description": "Ollama endpoint serving bge-m3 (used when EMBEDDING_PROVIDER=ollama). Must be https or loopback unless EMBEDDING_ALLOW_PLAINTEXT is set."
        },
        {
          "name": "OPENAI_API_KEY",
          "isSecret": true,
          "description": "OpenAI (or OpenAI-compatible) API key for text-embedding-3-* (required when EMBEDDING_PROVIDER=openai; the server refuses to start without it)."
        }
      ]
    }
  ],
  "repository": {
    "id": "1184745561",
    "url": "https://github.com/maxkuminov/obsidian-mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/maxkuminov/obsidian-mcp#readme",
  "description": "Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth"
}