obsidian-connector
A local MCP connector that lets you read, write, and search an Obsidian vault directly on disk — no plugins or running Obsidian instance required.
Read & Browse
List notes and folders (recursively or not); read full notes, a specific heading's section, or a line range
Get note metadata (created/modified dates, size, tags, frontmatter keys, link & task counts)
Search notes by text or regex, with optional tag, folder, and path-glob filters
List all tags with usage counts; get backlinks to a note; list outgoing links (flagging unresolved ones)
List tasks (
- [ ]/- [x]) across the vault or a single note, filterable by statusRead daily, weekly, or monthly periodic notes for today or a specific date
Write & Modify
Create notes with optional YAML frontmatter; append text to notes (optionally under a heading)
Edit notes via find/replace or by rewriting an entire heading section
Update or remove YAML frontmatter fields without touching the body
Toggle task checkboxes by line number
Move/rename notes with automatic
[[wikilink]]rewriting across the vaultDelete notes (moved to
.trash— recoverable)Append to or create daily, weekly, or monthly periodic notes
Create notes from templates with
{{title}},{{date}},{{time}}, and custom variable substitution
Safety
All file access is sandboxed to the configured vault folder; path-traversal is blocked
Deletions move files to
.trashrather than permanently removing them
Provides tools for reading, writing, searching, and managing Markdown notes in an Obsidian vault, including listing notes and folders, reading note content, full-text and tag search, getting backlinks, creating and appending notes, managing daily notes, and updating YAML frontmatter.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obsidian-connectorsearch notes tagged #meetings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vault Connector for Obsidian
A local MCP connector that lets Claude read, write and search any Obsidian vault. It works directly with the Markdown files on disk — no community plugins, and Obsidian does not need to be running.
Independent project, not affiliated with or endorsed by Obsidian. "Obsidian" is a trademark of Dynalist Inc.
All access is sandboxed to the single vault folder you configure; the server refuses any path that would escape it.
Tools
Tool | Access | Description |
| read | List Markdown notes, optionally within a folder |
| read | List sub-folders of the vault or a folder |
| read | Read a note — or just one heading's section / a line range |
| read | Note metadata: dates, size, tags, link & task counts |
| read | Text or regex search, with |
| read | List every tag in the vault with usage counts |
| read | Find notes linking to a target via |
| read | List links a note points to, flagging unresolved ones |
| read | List task checkboxes ( |
| write | Create a note with optional YAML frontmatter |
| write | Append text to a note, optionally under a heading |
| write | Find/replace text, or rewrite a heading's section |
| write | Set or remove YAML frontmatter fields |
| write | Toggle a task checkbox on a given line |
| write | Move/rename a note and rewrite |
| write (destructive) | Move a note to the vault's |
| write | Append an entry to today's (or a given date's) daily note |
| write | Append to a daily, weekly or monthly note |
| read | Read a daily, weekly or monthly note |
| write | Create a note from a template with |
Also exposes MCP prompts (summarize_note, daily_review) and a resource
(obsidian://vault/structure) describing the vault layout.
Related MCP server: @kazuph/mcp-obsidian
Configuration
The server is configured through environment variables (set automatically from the connector settings when installed as a Desktop Extension):
Variable | Required | Default | Purpose |
| yes | — | Absolute path to the vault folder |
| no | `` (root) | Vault-relative folder for daily notes |
| no |
| Daily-note filename format |
| no | daily folder | Folder for weekly notes |
| no |
| Weekly-note format ( |
| no | daily folder | Folder for monthly notes |
| no |
| Monthly-note filename format |
| no | `` (root) | Folder holding note templates |
Development
npm install
npm run build # compile TypeScript to dist/
npm run inspect # open the MCP Inspector against the serverTry it locally in Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "/absolute/path/to/your/Vault",
"OBSIDIAN_DAILY_FOLDER": "Log"
}
}
}
}Package as a Desktop Extension (.mcpb)
npm run pack # builds and produces obsidian-connector.mcpbThe resulting .mcpb can be installed in Claude Desktop with one click, or submitted to the
Claude connector directory via the
Desktop Extension submission form.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/noragami90/obsidian-connector'
If you have feedback or need assistance with the MCP directory API, please join our Discord server