Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
light-obsidian-mcp
MCP server for working with your Obsidian vault via Claude Desktop and other MCP-compatible clients.
Why light-obsidian-mcp?
Unlike other Obsidian integrations, this server works directly with the vault folder on your file system:
- No Obsidian plugins required — nothing to install or configure inside Obsidian itself
- Obsidian doesn't need to be running — read and write notes at any time, even when the app is closed
Tools
| Tool | Description |
|---|---|
read_note | Read a note by relative path |
write_note | Create or overwrite a note |
move_note | Move or rename a note within the vault |
list_notes | List .md files in a folder |
search_notes | Full-text search across notes |
delete_note | Delete a note by relative path |
get_frontmatter | Read YAML metadata from a note |
Installation
1. Install uv
pip install uvOr see other installation options.
2. Add to your Claude Desktop config
The example below shows setup for Claude Desktop, but the server works with any MCP-compatible client: Cursor, Windsurf, Zed, Continue, and others — the config format is the same.
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.jsonor%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": ["--python", "3.13", "light-obsidian-mcp"],
"env": {
"OBSIDIAN_VAULT": "C:\\path\\to\\your\\obsidian\\vault"
}
}
}
}Replace OBSIDIAN_VAULT with the path to your vault and restart your client.