Obsidian Everywhere MCP Server

Graph-native MCP server for reading, navigating, and safely editing Obsidian vaults.

Remote serverstreamable-http

What is the Obsidian Everywhere MCP Server?

Graph-native MCP server for reading, navigating, and safely editing Obsidian vaults.

The short version

  1. Notes are a graph and a semantic knowledge base, not a folder of text files. Backlinks, n-hop neighborhoods, shortest paths, PageRank, full-text search, and local multilingual embeddings turn a topic into focused, token-budgeted context. 2. Your vault should be usable where your agents run. The Remote Vault Bridge exposes that same graph and its guarded write tools over authenticated Streamable HTTP. A Claude Code or Codex process on another server can search, reason over, append to, and reorganize a vault that remains on your own machine.
  • 🧩 Graph + semantic context engine — a markdown parser (wikilinks, embeds,
  • 🌍 Remote Vault Bridge — agents on an external server get the same search,
  • 🧠 Local semantic search — semantic_search and get_related with
  • 🛡️ Safe writes and resilient mounts — partial edits, dry-run-first bulk
  • 🛠️ 39 graph-native MCP tools — structured reads, graph navigation,

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
vault_overviewNote counts, top tags, PageRank hub notes, recently modified — a starting orientation
vault_statusMount availability, index freshness, write availability, and last full reconciliation
search_notesFull-text search with tag/folder filters (with a trigram fallback for CJK substring matches unicode61 alone would miss — see DECISIONS.md D9), each result annotated with link counts and tags
semantic_searchMeaning-based search via local embeddings (multilingual-e5-small, no external service) — finds conceptually related notes that don't share the query's exact words
read_noteStructured content/frontmatter/links/tags plus line pagination; optional heading-scoped read
list_notesExplicit folder-aware note listing with pagination; optionally projects named frontmatter fields (e.g. status, project) per note
list_folderImmediate child folders, notes, and attachments
regex_searchJavaScript-regex search with file, line, and excerpt
get_backlinksEvery note linking to a given note, with the linking sentence
get_neighborhoodExplicit n-hop node/edge list around a note (links treated as undirected)
get_context_bundle**The killer feature.** Center note + prioritized 1-hop neighbors packed into a token budget
list_tagsFull nested tag hierarchy with counts
get_notes_by_tagNotes carrying a given tag (nested-aware)
find_orphansNotes with no incoming or outgoing links

How to install the Obsidian Everywhere MCP Server

{
  "mcpServers": {
    "obsidian-everywhere": {
      "command": "npx",
      "args": ["-y", "obsidian-everywhere"],
      "env": {
        "OBSIDIAN_EVERYWHERE_CLIENT_TOKEN": "your-value",
        "OBSIDIAN_VAULT_PATH": "your-value",
        "OBSIDIAN_EVERYWHERE_TOKEN": "your-value",
        "OAUTH_LOGIN_SECRET": "your-value",
        "OAUTH_ISSUER_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OBSIDIAN_EVERYWHERE_CLIENT_TOKENCredential the server authenticates with.Yes
OBSIDIAN_VAULT_PATHFilesystem location the server is allowed to use.Optional
OBSIDIAN_EVERYWHERE_TOKENCredential the server authenticates with.Yes
OAUTH_LOGIN_SECRETCredential the server authenticates with.Yes
OAUTH_ISSUER_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Obsidian Everywhere to vault overview.”
  • “Use Obsidian Everywhere to vault status.”
  • “Use Obsidian Everywhere to search notes.”

Frequently asked questions

Graph-native MCP server for reading, navigating, and safely editing Obsidian vaults. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.