F
licenseNot graded
qualityD
maintenanceMCP server that exposes Obsidian vault operations over HTTP via the Obsidian CLI, enabling note management, search, and daily note operations.
1
-
obsidian-mcp
by C0d1g0v3c
Provides tools for searching, listing, reading, creating, editing, and appending notes in an Obsidian vault by working directly on the markdown files.
Click on "Deploy 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 all 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
A small Model Context Protocol server that gives an MCP client (such as Claude Code or Claude Desktop) read and write access to an Obsidian vault by working directly on the markdown files.
No Obsidian plugins required and the app does not need to be running — the server
reads and writes the .md files on disk.
Features
Works directly on the vault's files (no Local REST API plugin needed).
Path-traversal safe: every path is resolved inside the vault;
../escapes are rejected.Ignores
.obsidian,.git,.trashandnode_modules.
Tools
Tool | Description |
| Full-text search across all notes, with line snippets |
| List notes in the whole vault or a subfolder |
| Read a note by its vault-relative path |
| Create a new note (creates folders; won't overwrite unless asked) |
| Replace an exact string in a note ( |
| Append text to the end of a note |
Related MCP server: obsidian-mcp
Requirements
Node.js >= 18
Installation
git clone https://github.com/C0d1g0v3c/obsidian-mcp.git
cd obsidian-mcp
npm installConfiguration
The server requires the OBSIDIAN_VAULT environment variable: the absolute path
to your vault. It exits with an error if it is not set.
Usage with Claude Code
claude mcp add obsidian --scope user \
-e OBSIDIAN_VAULT="/absolute/path/to/your/vault" \
-- node /absolute/path/to/obsidian-mcp/index.jsUsage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/absolute/path/to/obsidian-mcp/index.js"],
"env": {
"OBSIDIAN_VAULT": "/absolute/path/to/your/vault"
}
}
}
}Running directly
OBSIDIAN_VAULT="/absolute/path/to/your/vault" node index.jsThe server communicates over stdio and is meant to be launched by an MCP client.
License
ISC
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceMCP server that exposes an Obsidian vault (search, read, create, and update notes) via Streamable HTTP.-
- AlicenseNot gradedqualityCmaintenanceMCP server for interacting with Obsidian via the Local REST API, enabling file operations, search, and content editing in your vault.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server to interact with Obsidian via the Local REST API community plugin, enabling file listing, search, content manipulation, and note management.MIT