Obsidian MCP Server
Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth
Obsidian MCP Server scores 52 (Fair), with no SPDX license recorded. It installs as a local process. It does not declare tools yet. Filed under AI and memory, Productivity. Install configs are generated for 10 clients. Being listed in the registry is not the same as being vendor-official.
Fair trust
52 of 100 from six public signals. Nobody can buy a point.
- Listed in the official MCP registry.
- No license recorded.
License, quality and maintenance
Where the 52 comes from
22 + 20 + 0 + 0 + 7 + 3 = 52. Each factor is capped, so no single signal can carry a listing.
Active in the official MCP registry, plus a known vendor namespace.
Registry: 22 of 30 points.How recently the repository saw a commit or release.
Maintenance: 20 of 20 points.GitHub stars and weekly downloads, on a log scale.
Popularity: 0 of 20 points.A clear, OSI-style open-source license.
License: 0 of 10 points.Not archived, a secure install path, a pinned version.
Security: 7 of 10 points.A real summary, a README with depth, listed tools.
Docs: 3 of 10 points.Install
Pick your client, copy the config, paste it in.
{ "mcpServers": { "maxkuminov-obsidian-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/maxkuminov/obsidian-mcp:v1.2.0" ], "env": { "DATABASE_URL": "YOUR_DATABASE_URL", "VAULT_PATH": "/obsidian", "SECRET_KEY": "YOUR_SECRET_KEY", "MCP_HOSTNAME": "", "EMBEDDING_PROVIDER": "ollama", "OLLAMA_URL": "http://ollama:11434", "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY", "TEI_URL": "http://tei:80", "TEI_EMBEDDING_MODEL": "BAAI/bge-m3", "TEI_EMBED_BATCH_SIZE": "16" } } }}
Environment variables
| Name | Required | Notes |
|---|---|---|
DATABASE_URLSecret | Required | 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. |
VAULT_PATH | Required | 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_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 explicitly. |
EMBEDDING_PROVIDER | Optional | Embedding provider: `ollama` (self-hosted, default), `openai` (bring your own key) or `tei` (Hugging Face Text Embeddings Inference, native /embed). Switching after deploy requires `make reset-embeddings`. |
OLLAMA_URL | Optional | Ollama endpoint serving bge-m3 (used when EMBEDDING_PROVIDER=ollama). Must be https or loopback unless EMBEDDING_ALLOW_PLAINTEXT is set. |
OPENAI_API_KEYSecret | Optional | OpenAI (or OpenAI-compatible) API key for text-embedding-3-* (required when EMBEDDING_PROVIDER=openai; the server refuses to start without it). |
TEI_URL | Optional | TEI endpoint (used when EMBEDDING_PROVIDER=tei). Must be https or loopback unless EMBEDDING_ALLOW_PLAINTEXT is set. |
TEI_EMBEDDING_MODEL | Optional | 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 reset-embeddings`. |
TEI_EMBED_BATCH_SIZE | Optional | Inputs per TEI /embed request (1-256). A value above the server's max_client_batch_size refuses startup. |
Tools
All capabilitiesTools show up when the registry metadata or the repository README lists them. Public READMEs are read directly. A GitHub token is used only when one is already configured.
About
Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth
Frequently asked questions
What is Obsidian MCP Server?
Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth
How do I install Obsidian MCP Server in Claude Desktop, Cursor, or VS Code?
Pick your client in the Install section on this page and copy the generated config into the client's config file. Step-by-step guides: Claude Desktop, Cursor, and VS Code. Obsidian MCP Server is published as the Docker image ghcr.io/maxkuminov/obsidian-mcp:v1.2.0.
How is Obsidian MCP Server's trust score calculated?
Obsidian MCP Server scores 52 out of 100 (Fair). The score adds six capped public signals: registry status, maintenance, popularity, license, documentation, and security. Nobody can pay for points. Read the methodology for the full formula.
Reviews
No reviews yet—Be the first to review
No published reviews yet. Used it? Tell the next person how it went.
Sign inA verified email is required to review this server.
Add badge to your README
Paste either snippet into the repository README. The image links to this listing.
Manage this listing
Claim this serverRelated servers
projectmem
by riponcm · Python
Coding agent memory — one local MCP server for every project. Warns before repeating failed fixes.
misakanet
by ikalus1988 · Python
Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.
Bhived MCP
by artkeyai · TypeScript
Shared memory for AI agents: query proven fixes, avoid known mistakes, and find skills and MCPs.
Graphicle
by graphicle-ai · Rust
Code graph and project memory for coding agents, cited to exact files and lines, on your machine.
Compartment
by maxfreedompollard · Python
Durable agentic memory, encrypted at rest. Fully offline: no network, no API key, no cloud.
Mnemosyne
by 28naem-del · TypeScript
Evidence-tracked local memory MCP server: one SQLite file; corrections retire dependent memories.