# Obsidian MCP Server

Connects MCP clients to an Obsidian vault that agents can use as shared memory. It searches notes by meaning and keywords and works with wikilink connections.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20 repo stars
- Author: maxkuminov
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/maxkuminov/obsidian-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/maxkuminov-obsidian-mcp-server

## What it does

This server gives MCP clients access to Markdown files in an Obsidian vault. An agent can search by keyword or meaning, follow wikilinks, and use graph operations across notes. The memory stays in readable files that you can open and edit in Obsidian.

Before applying an edit, the server can check `expected_hash` and reject a change based on an outdated read. Publishing is atomic, deleted files go to `.trash/`, and `dry_run` returns a diff before changes are applied. The listed stack is Python 3.12, FastAPI, and PostgreSQL with pgvector. It is self-hosted, so you need to deploy the server and configure a client connection; the README shows an HTTP connection with an authorization token for Claude Code.

## Requirements
- Needs: Docker
- Environment variables: `DATABASE_URL`, `VAULT_PATH`, `SECRET_KEY`, `MCP_HOSTNAME`, `EMBEDDING_PROVIDER`, `OLLAMA_URL`, `OPENAI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Obsidian

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search vault notes by meaning or keywords
- follow wikilink connections between notes
- keep agent memory in ordinary Markdown files
- reject edits based on stale note contents

## Example prompts
- Search my vault for notes about this project and follow their wikilinks.
- Save a summary of this session in the right Obsidian note.
- Show me the diff for this note change before applying it.

## Similar
- [obsidian-headless](https://affpapa.org/en/nevibecode/skills/obsidian-headless.md) — skill · 1200 installs
- [obsidian-markdown](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-markdown.md) — skill · 593 installs
- [obsidian-kb-artifacts](https://affpapa.org/en/nevibecode/skills/obsidian-kb-artifacts.md) — skill · 328 installs
- [obsidian](https://affpapa.org/en/nevibecode/skills/julianobarbosa-obsidian.md) — skill · 244 installs
- [obsidian-mcp-server](https://affpapa.org/en/nevibecode/mcp/obsidian-mcp-server.md) — MCP server · ★ 715 repo stars
- [Engram: AI memory you can edit in Obsidian](https://affpapa.org/en/nevibecode/mcp/engram-ai-memory-you-can-edit-in-obsidian.md) — MCP server · ★ 2 repo stars

---
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
