Obsidian MCP Server
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_URLsecret required · PostgreSQL 16 + pgvector (0.8.0+) connection URL for the app's NON-superuser role, e.g…VAULT_PATHrequired · Path of the Obsidian vault inside the container (mount your vault read-write there).SECRET_KEYsecret required · itsdangerous signer for cookies/sessions. Generate with `openssl rand -hex 32`; the app refuses to start on a placeholder.MCP_HOSTNAMErequired · 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_KEYsecret · 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_KEYsecret · 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
-
obsidian-mcp-server
MCP serversRead, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.
obsidian-mcp-server@3.9.0 -
Instant, private access to your knowledge base: Zotero, Obsidian, Apple Notes (macOS).
@docsagent/docsagent@5.0.1 -
obsidian-sync-mcp
MCP serversMCP server for Obsidian — access your vault from any AI agent, even when your machine is off. Powered by Self-hosted LiveSync.
git clone https://github.com/es617/obsidian-sync-mcp.git -
obsidian-mcp-plugin
MCP serversHigh-performance Model Context Protocol (MCP) server for Obsidian that provides AI tools with direct vault access through semantic operations and HTTP transport.
git clone https://github.com/aaronsb/obsidian-mcp-plugin.git -
obsidian-sync-vault-ce
MCP serversAn Open Framework for Obsidian Cloud Sync, Media Playback, P2P Connection with MCP capability. Currently Support Baidu/Aliyun/Quark/WebDAV/S3
git clone https://github.com/abcamus/obsidian-sync-vault-ce.git -
seekstone
MCP serversThe 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.
git clone https://github.com/shaqmughal/seekstone.git