# Obsidian

Connects AI assistants to an Obsidian vault via the Local REST API plugin for note reading, searching, and precise editing.

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

## What it does

This server bridges your AI agent and an Obsidian knowledge base using the community Local REST API plugin. It can inspect root directories, list files in specific folders, read note contents, run text searches across the vault, and remove files.

Writing tools support both appending to notes and precise modifications. Through `patch_content`, the model can insert text relative to a heading, a block reference, or a frontmatter property. Appending works on both existing and new files.

Obsidian must stay running with the REST plugin enabled. The server executes through `uvx` and depends on two parameters: `OBSIDIAN_API_KEY` and `OBSIDIAN_HOST`.

## Requirements
- Needs: Docker
- 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 for matching text across the entire vault
- retrieve and summarize architecture meeting notes
- insert updates under a specific heading or frontmatter field
- append generated action items to an existing note

## Example prompts
- Search Obsidian for notes mentioning Azure CosmosDb and explain their context
- Read the latest architecture discussion note and extract key decisions
- Summarize our meeting and save it as a new note named summary meeting.md

## Similar
- [Obsidian Vault MCP Server](https://affpapa.org/en/nevibecode/mcp/obsidian-vault-mcp-server.md) — MCP server · ★ 13 repo stars
- [obsidian-source-ingestion](https://affpapa.org/en/nevibecode/skills/obsidian-source-ingestion.md) — skill · 329 installs
- [obsidian-distill](https://affpapa.org/en/nevibecode/commands/obsidian-distill.md) — command · ★ 5412 repo stars
- [obsidian-organizer](https://affpapa.org/en/nevibecode/skills/obsidian-organizer.md) — skill · 1900 installs
- [obsidian-notes-creator](https://affpapa.org/en/nevibecode/skills/obsidian-notes-creator.md) — skill · 689 installs
- [obsidian-bases](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-bases.md) — skill · 547 installs

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