Skip to main content
MCP server CX Codex

Obsidian — Claude Code MCP server: what it does, how to install

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

no license updated 2026-10-29

Open on GitHub

What Obsidian 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.

What it helps with

  • 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 for the agent

  • 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

How to install Obsidian

Install

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Obsidian

How do you install the Obsidian MCP server?

Enable the Local REST API community plugin inside Obsidian and copy your key. Then add uvx mcp-obsidian to your MCP configuration with OBSIDIAN_API_KEY and OBSIDIAN_HOST.

What capabilities does this server provide?

It grants file browsing, text search across the vault, note reading, file deletion, and targeted content patching.

Does it support targeted edits inside an existing note?

Yes, the patch_content tool allows inserting text relative to headings, block references, or frontmatter fields.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open