obsidian-mcp
Allows reading, writing, searching, and organizing notes in an Obsidian vault directly via the filesystem, with automatic syncing when Obsidian is open.
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-mcplist my notes in the Projects folder"
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.
obsidian-mcp
An MCP (Model Context Protocol) server that lets AI coding agents (Claude Code, Codex CLI, etc.) read, write, search, and organize notes in an Obsidian vault. It works directly on the filesystem, so Obsidian doesn't need to be running — Obsidian picks up external changes automatically.
Community project — not affiliated with Obsidian.
Setup
git clone https://github.com/Mochiduki-0715/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run buildConfiguration is done through environment variables:
Variable | Description | Default |
| Absolute path to your vault folder | (required) |
| Folder for daily notes, relative to the vault root |
|
Registering with agents
Claude Code
claude mcp add --scope user obsidian \
--env OBSIDIAN_VAULT_PATH=$HOME/path/to/your/vault \
-- node /path/to/obsidian-mcp/dist/index.jsCodex CLI
Add to ~/.codex/config.toml:
[mcp_servers.obsidian]
command = "node"
args = ["/path/to/obsidian-mcp/dist/index.js"]
[mcp_servers.obsidian.env]
OBSIDIAN_VAULT_PATH = "/path/to/your/vault"Tools
Tool | Description |
| List notes, newest first; optionally restricted to a subfolder |
| Read a note, returning parsed frontmatter and the markdown body |
| Create a note (pass |
| Append text; with |
| Edit by exact string replacement ( |
| Case-insensitive full-text search, with an optional |
| Move/rename a note and rewrite |
| Move a note to the vault's |
| Get or create the daily note for today or a given date |
Safety
Every path is resolved inside the vault root;
..escapes are rejectedDeleting moves notes to Obsidian's standard
.trash/folder instead of removing themcreate_notenever silently overwrites an existing note (an explicit flag is required)
License
This server cannot be installed
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/Mochiduki-0715/obsidian-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server