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
Option 1: mcpb bundle (recommended)
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)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_obsidian_vault-0.5.0.tar.gz | 7.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|