obsidianMCP
Allows reading, searching, listing, creating, and updating notes in an Obsidian vault.
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., "@obsidianMCPsearch notes for 'weekly review'"
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 Server
An MCP server that gives Claude access to your Obsidian vault — read, search, and write notes directly from a conversation.
Prerequisites
Node.js v20 or later
Related MCP server: stellavault
Installation
git clone <repo-url>
cd obsidianMCP
npm install
npm run buildClaude Desktop configuration
Add the server to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/absolute/path/to/obsidianMCP/dist/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "/absolute/path/to/your/vault"
}
}
}
}Restart Claude Desktop after saving the file.
Available tools
Tool | Description |
| List all |
| Return the full content of a note by its vault-relative path (e.g. |
| Case-insensitive full-text search. Returns the matching file path and a snippet (matched line ± 1 line of context) for each hit. |
| Create a new note. Fails if the file already exists. Intermediate directories are created automatically. |
| Overwrite an existing note with new content. Fails if the file does not exist. |
Security note
Keep OBSIDIAN_VAULT_PATH in the env block of your Claude Desktop config — never hard-code it in the source or commit it to version control. Add a .env file to .gitignore if you use one locally for development.
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
- TaprootOAuthcom.taproothq
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- AlicenseAqualityCmaintenanceA local MCP connector that lets Claude read, write and search any Obsidian vault directly from disk.20MIT
- AlicenseNot gradedqualityAmaintenanceEnables Claude to read, search, and analyze your entire knowledge vault locally via MCP tools like search, drafting, and linting.45 npm4MIT
- AlicenseAqualityBmaintenanceEnables semantic search and reading of Obsidian Markdown notes through read-only MCP tools, allowing Claude to retrieve relevant passages from a local vault.3MIT
- AlicenseNot gradedqualityBmaintenanceGives Claude and other MCP clients full control of a running Obsidian vault through the official Obsidian CLI, with fast filesystem reads for bulk operations and link-safe writes via the app.8 npmMIT