SERVER

Obsidian MCP Server

Rank #4,885

io.github.maxkuminov/obsidian-mcp

Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth

1 version

18 GitHub stars

by maxkuminov (1 servers)View repository ↗

First listed

May 17, 2026

Last publish date

Oct 29, 2026

PURPOSE

What you can do with Obsidian MCP Server

Obsidian MCP Server is a Model Context Protocol (MCP) server published by maxkuminov. It ranks #4,885 of 163,719 active servers on MCP Toplist, and its repository has 18 GitHub stars. Obsidian MCP Server is listed across 2 registries — Official MCP and Glama, with 1 tracked version. It was first listed on May 17, 2026 and most recently updated on Oct 29, 2026.

Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.

CAPABILITIES AND LIMITATIONS

What Obsidian MCP Server can and cannot do

Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.

REQUIREMENTS

What you need before using Obsidian MCP Server

DeclaredAPI keyCredentials declared

The registry listing declares required configuration before first use — typically an API key, token or connection string set via environment variables.

Declared by Glama, last synced Oct 30, 2026. Not independently verified by MCP Toplist.

Declared in the registry install config

DATABASE_URL · required
VAULT_PATH · required
SECRET_KEY · required
MCP_HOSTNAME · required
EMBEDDING_PROVIDER · optional
OLLAMA_URL · optional
OPENAI_API_KEY · optional

INSTALLATION AND FIRST TASK

Connect Obsidian MCP Server and confirm it works

Docker image

claude mcp add obsidian-mcp -e "DATABASE_URL=<your DATABASE_URL>" -e "VAULT_PATH=<your VAULT_PATH>" -e "SECRET_KEY=<your SECRET_KEY>" -e "MCP_HOSTNAME=<your MCP_HOSTNAME>" -e "EMBEDDING_PROVIDER=<your EMBEDDING_PROVIDER>" -e "OLLAMA_URL=<your OLLAMA_URL>" -e "OPENAI_API_KEY=<your OPENAI_API_KEY>" -- docker run -i --rm ghcr.io/maxkuminov/obsidian-mcp:v0.9.3

Replace each placeholder with your own value before saving.

Docker image

[mcp_servers.obsidian-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"]

[mcp_servers.obsidian-mcp.env]
DATABASE_URL = "<your DATABASE_URL>"
VAULT_PATH = "<your VAULT_PATH>"
SECRET_KEY = "<your SECRET_KEY>"
MCP_HOSTNAME = "<your MCP_HOSTNAME>"
EMBEDDING_PROVIDER = "<your EMBEDDING_PROVIDER>"
OLLAMA_URL = "<your OLLAMA_URL>"
OPENAI_API_KEY = "<your OPENAI_API_KEY>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"
      ],
      "env": {
        "DATABASE_URL": "<your DATABASE_URL>",
        "VAULT_PATH": "<your VAULT_PATH>",
        "SECRET_KEY": "<your SECRET_KEY>",
        "MCP_HOSTNAME": "<your MCP_HOSTNAME>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OLLAMA_URL": "<your OLLAMA_URL>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"
      ],
      "env": {
        "DATABASE_URL": "<your DATABASE_URL>",
        "VAULT_PATH": "<your VAULT_PATH>",
        "SECRET_KEY": "<your SECRET_KEY>",
        "MCP_HOSTNAME": "<your MCP_HOSTNAME>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OLLAMA_URL": "<your OLLAMA_URL>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Docker image

{
  "servers": {
    "obsidian-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"
      ],
      "env": {
        "DATABASE_URL": "<your DATABASE_URL>",
        "VAULT_PATH": "<your VAULT_PATH>",
        "SECRET_KEY": "<your SECRET_KEY>",
        "MCP_HOSTNAME": "<your MCP_HOSTNAME>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OLLAMA_URL": "<your OLLAMA_URL>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"
      ],
      "env": {
        "DATABASE_URL": "<your DATABASE_URL>",
        "VAULT_PATH": "<your VAULT_PATH>",
        "SECRET_KEY": "<your SECRET_KEY>",
        "MCP_HOSTNAME": "<your MCP_HOSTNAME>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OLLAMA_URL": "<your OLLAMA_URL>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v0.9.3"
      ],
      "env": {
        "DATABASE_URL": "<your DATABASE_URL>",
        "VAULT_PATH": "<your VAULT_PATH>",
        "SECRET_KEY": "<your SECRET_KEY>",
        "MCP_HOSTNAME": "<your MCP_HOSTNAME>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OLLAMA_URL": "<your OLLAMA_URL>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

First successful task

After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed: May 17, 2026
Latest version published: Oct 29, 2026
Version history: 1 version tracked (below)
Requirements evidence: Declared by Glama, last synced Oct 30, 2026. Not independently verified by MCP Toplist.
Profile checked: Not yet — purpose, capabilities and requirements above come from registry data only
Ranking data as of: Oct 30, 2026

Registry sightings

Glama ↗listed since May 18, 2026 · still listed
Official MCP ↗listed since Oct 30, 2026 · still listed

Do you maintain Obsidian MCP Server? to correct or enrich this profile.

VERSIONS

Available versions (1)

Version	Published
0.9.3	Oct 29, 2026

STANDING

#4,885of 163,719 active serversTop 5%

Ranks ahead of 158,834 of 163,719 servers on MCP Toplist.

Recent momentum

+16GitHub stars since May 18 (+800%)

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.maxkuminov%2Fobsidian-mcp.svg)](https://mcptoplist.com/server/io.github.maxkuminov%2Fobsidian-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.maxkuminov%2Fobsidian-mcp"><img src="https://mcptoplist.com/badge/io.github.maxkuminov%2Fobsidian-mcp.svg" alt="MCP Toplist: Top 5% of 163,719" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains Obsidian MCP Server?: Obsidian MCP Server is maintained by maxkuminov, which publishes 1 MCP server (1 total version) tracked on MCP Toplist.
Is Obsidian MCP Server listed on the Official MCP Registry?: Yes — Obsidian MCP Server is listed on the Official MCP Registry, alongside Glama.
How many versions does Obsidian MCP Server have?: MCP Toplist tracks 1 version of Obsidian MCP Server, most recently published on Oct 29, 2026.
Where can I find the source code for Obsidian MCP Server?: The source code for Obsidian MCP Server is hosted at github.com/maxkuminov/obsidian-mcp.

Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers