Skip to main content

Obsidian MCP

Give Claude Desktop access to your Obsidian vault. No plugins required.

Install the extension, and Claude can read your notes, search them, and create new ones.

Installation

Download obsidian-mcp.mcpb from releases and open it with Claude Desktop.

Option 2: uvx

uvx mcp-obsidian-vault

Option 3: Manual config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian-vault"]
    }
  }
}

Tools

Tool Description
list_vaults List all Obsidian vaults on your machine
list_notes List all notes in a vault
read_note Read note contents with parsed YAML frontmatter
write_note Create or update a note
search_notes Full-text search across notes
open_in_obsidian Open a note directly in Obsidian app

How It Works

No plugins required — we use Obsidian's native interfaces:

What How
Find vaults Read obsidian.json (Obsidian stores vault paths here)
Read/write notes Direct filesystem access (your vault is just markdown files)
Frontmatter YAML parsing with structured JSON output
Search Full-text search
Open in app Native obsidian:// URI scheme

Status

Feature Status
Vault discovery ✅
Read/write notes ✅
Search ✅
Frontmatter parsing ✅
Open in Obsidian ✅
PyPI release ✅
mcpb bundle ✅

Security

This MCP is designed with minimal access:

  • No network calls — Nothing leaves your machine
  • No files outside vaults — Only accesses your Obsidian notes
  • No credentials — Never touches passwords or tokens
  • Open source — Audit the code yourself

See SECURITY.md for full details, or visit the Security page on our website.

Documentation

Document What's Inside
CLAUDE.md Development approach, current status
SECURITY.md Security model and what we access
docs/ Architecture diagrams, roadmap

Contributing

Check the issues if you want to help.

License

MIT

Metadata

Release files for mcp-obsidian-vault 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-obsidian-vault 0.5.0
File Size Uploaded
mcp_obsidian_vault-0.5.0.tar.gz 7.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-obsidian-vault 0.5.0
File Interpreter ABI Platform
mcp_obsidian_vault-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.7 kB

Release files / mcp_obsidian_vault-0.5.0.tar.gz

Download URL mcp_obsidian_vault-0.5.0.tar.gz
Size 7.2 kB
Tags Source
SHA-256 checksum
How to use checksums
25de1a26cff8e27df5f1615c5165600a39f8058121744a782ec57d8baa98bb71
BLAKE2b-256 checksum
How to use checksums
301e0e99c754470ca886241a3b3e9833fc3074cee1887cb9c7ab6b72e5f8f51c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.1 CPython/3.11.14 Linux/6.11.0-1018-azure

Release files / mcp_obsidian_vault-0.5.0-py3-none-any.whl

Download URL mcp_obsidian_vault-0.5.0-py3-none-any.whl
Size 8.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e8eae46305712fbc0035664923ad86b912f7d28e3eb2ac69f0723e25d725ea01
BLAKE2b-256 checksum
How to use checksums
1e390e392f7c3281689c33fdf36c37f85c950f78cc2787f6705482c72f670a66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.1 CPython/3.11.14 Linux/6.11.0-1018-azure

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page