InnerVault

Obsidian MCP Server

Stale Official MCP Registry, io.github.maxkuminov

Self-hosted agent memory in an Obsidian vault: hybrid search, link graph, tasks, safe writes, OAuth

Open the source (opens github.com) https://github.com/maxkuminov/obsidian-mcp

Before you use it

  • Runs on your computer with your permissions. Read what it can do before connecting it to an agent.
  • Needs credentials: DATABASE_URL, OPENAI_API_KEY, SECRET_KEY, TEI_API_KEY. Use a key with the least access you can.

What it is

MCP servers from io.github.maxkuminov.

The problem it solves and who it suits haven't been reviewed by InnerVault. The description above is the source's own.

How to get it

oci package (streamable-http)

ghcr.io/maxkuminov/obsidian-mcp:v1.5.0

From the server's entry in the official MCP Registry

Settings it asks for

  • DATABASE_URL secret required · PostgreSQL 16 + pgvector (0.8.0+) connection URL for the app's NON-superuser role, e.g…
  • VAULT_PATH required · Path of the Obsidian vault inside the container (mount your vault read-write there).
  • SECRET_KEY secret required · itsdangerous signer for cookies/sessions. Generate with `openssl rand -hex 32`; the app refuses to start on a placeholder.
  • MCP_HOSTNAME required · Public hostname your reverse proxy routes to. Also derives BASE_URL, ALLOWED_ORIGINS and ALLOWED_HOSTS as https://<MCP_HOSTNAME> unless those are set…
  • EMBEDDING_PROVIDER · Embedding provider: `ollama` (self-hosted, default), `openai` (bring your own key) or `tei` (Hugging Face Text Embeddings Inference, native /embed). Switching…
  • OLLAMA_URL · Ollama endpoint serving bge-m3 (used when EMBEDDING_PROVIDER=ollama). Must be https or loopback unless EMBEDDING_ALLOW_PLAINTEXT is set.
  • OPENAI_API_KEY secret · OpenAI (or OpenAI-compatible) API key for text-embedding-3-* (required when EMBEDDING_PROVIDER=openai; the server refuses to start without it).
  • TEI_URL · TEI endpoint (used when EMBEDDING_PROVIDER=tei). Must be https or loopback unless EMBEDDING_ALLOW_PLAINTEXT is set.
  • TEI_EMBEDDING_MODEL · Must equal the model_id the TEI server reports at GET /info, exactly (a local path included); a different value refuses startup. A change needs `make…
  • TEI_EMBED_BATCH_SIZE · Inputs per TEI /embed request (1-256). A value above the server's max_client_batch_size refuses startup.
  • TEI_API_KEY secret · Bearer token for a TEI server started with --api-key; sent only to TEI_URL (/embed, /info, the panel's /health). Empty means no Authorization header.

Related

  1. obsidian-mcp-server

    MCP servers

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

    Stale Official MCP Registry, io.github.cyanheads 695 ★Updated 5 days ago 1 note

    obsidian-mcp-server@3.9.0
  2. Instant, private access to your knowledge base: Zotero, Obsidian, Apple Notes (macOS).

    Stale Official MCP Registry, io.github.docsagent 572 ★Updated 49 days ago 1 note

    @docsagent/docsagent@5.0.1
  3. obsidian-sync-mcp

    MCP servers

    MCP server for Obsidian — access your vault from any AI agent, even when your machine is off. Powered by Self-hosted LiveSync.

    Stale GitHub, es617 71 ★MITUpdated 8 days ago

    git clone https://github.com/es617/obsidian-sync-mcp.git
  4. obsidian-mcp-plugin

    MCP servers

    High-performance Model Context Protocol (MCP) server for Obsidian that provides AI tools with direct vault access through semantic operations and HTTP transport.

    Stale GitHub, aaronsb 468 ★MITUpdated 17 days ago

    git clone https://github.com/aaronsb/obsidian-mcp-plugin.git
  5. An Open Framework for Obsidian Cloud Sync, Media Playback, P2P Connection with MCP capability. Currently Support Baidu/Aliyun/Quark/WebDAV/S3

    Stale GitHub, abcamus 143 ★Custom licence (see repository)Updated 4 days ago

    git clone https://github.com/abcamus/obsidian-sync-vault-ce.git
  6. seekstone

    MCP servers

    The Obsidian MCP server that needs no plugin, no running Obsidian app — and doesn't blow your context window. Filesystem-direct: single-digit-ms keyword search, ~26 ms local semantic search, ~2 KB payloads, 25 tools.

    Indexed GitHub, shaqmughal 35 ★MITUpdated yesterday

    git clone https://github.com/shaqmughal/seekstone.git