# Obsidian Everywhere

This MCP server connects agents to a local Obsidian vault for graph-aware search, bounded context, guarded edits, and optional Git checks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: junnnnnw00
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/junnnnnw00/obsidian-everywhere
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/obsidian-everywhere

## What it does

Obsidian Everywhere turns a local vault into searchable agent context. It parses Markdown links, embeds, frontmatter, tags, headings, and block references, then combines SQLite full-text search with an in-memory graph. `get_context_bundle` returns a focused package around a topic, with graph traversal and semantic retrieval available for related notes.

The server can run beside the vault over local stdio or expose the same tools through authenticated HTTP for a remote agent. Write operations support dry runs, rollback snapshots, and recovery when a removable drive, NAS share, or container mount disappears. Git features are opt-in: status, bounded diffs, history, selected-file commits, and HTTPS pushes use preview and one-use approval steps.

Semantic retrieval is off by default. To enable it, install `@huggingface/transformers@^4.2.0` and set `OBSIDIAN_EVERYWHERE_ENABLE_SEMANTIC=true`; `multilingual-e5-small` is downloaded locally and then runs offline. The server keeps the vault on the machine you control, so remote access is transport rather than vault synchronization.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Obsidian

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add obsidian-everywhere -- npx -y obsidian-everywhere
```

### Codex

**Platform CLI**
```bash
codex mcp add obsidian-everywhere -- npx -y obsidian-everywhere
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "obsidian-everywhere": {
            "command": "npx",
            "args": [
                "-y",
                "obsidian-everywhere"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "obsidian-everywhere": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "obsidian-everywhere"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add obsidian-everywhere npx -y obsidian-everywhere
```

## When to use it
- search a vault by meaning and exact text
- build focused context from linked Obsidian notes
- apply a guarded edit to a local vault
- review repository changes before committing
- recover after a mounted vault disappears

## Example prompts
- Search my vault for notes about the migration and return the connected context.
- Find the shortest path between `Project Alpha` and `API decisions`.
- Prepare a guarded edit for this note, show the dry run first, and wait for approval.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md