Obsidian MCP Server
@StevenStavrakis
About Obsidian MCP Server
A simple MCP server for Obsidian
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": [
"-y",
"obsidian-mcp",
"/path/to/your/vault"
]
}
}
}Tools
12Read the contents of a note
Create a new note
Edit an existing note
Delete a note
Move a note to a different location
Create a new directory
Search notes in the vault
Add tags to a note
Remove tags from a note
Rename a tag across all notes
List and organize tags
List all available vaults (helps with multi-vault setups)
Overview
What is Obsidian MCP Server?
An MCP (Model Context Protocol) server that enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags. It is designed for Obsidian users who want to let AI assistants directly manage their note-taking vault.
How to use Obsidian MCP Server?
Install manually by adding the server to your Claude Desktop configuration file, specifying the absolute path(s) to your Obsidian vault(s). The server runs via npx obsidian-mcp <vault-path>. A Smithery installation option is available but not recommended by the author. Requires Node.js 20 or higher.
Key features of Obsidian MCP Server
- Read and search notes in your vault
- Create new notes and directories
- Edit and delete existing notes
- Move notes between locations
- Manage tags (add, remove, rename)
- Support for multiple vaults
Use cases of Obsidian MCP Server
- AI assistant reads and summarises notes from your vault
- Automatically create, organise, or update notes via prompts
- Bulk tag management across multiple notes
- Move or restructure notes within the vault
FAQ from Obsidian MCP Server
What backup is recommended before using Obsidian MCP Server?
The README strongly advises backing up your Obsidian vault prior to use, recommending git or any backup method, because the server has read and write access and is in active development.
What are the runtime requirements?
Node.js 20 or higher and an Obsidian vault are required.
Where does the data live?
The server reads and writes directly to your local Obsidian vault directory. No cloud storage is mentioned; all data stays on your machine.
What are known limitations?
The tools have been tested but not thoroughly, and the server is in active development.
What transport does the server use?
The server is configured to run as a local MCP server via stdio (command-line interface). No network transports are mentioned.
Frequently asked questions
What backup is recommended before using Obsidian MCP Server?
The README strongly advises backing up your Obsidian vault prior to use, recommending git or any backup method, because the server has read and write access and is in active development.
What are the runtime requirements?
Node.js 20 or higher and an Obsidian vault are required.
Where does the data live?
The server reads and writes directly to your local Obsidian vault directory. No cloud storage is mentioned; all data stays on your machine.
What are known limitations?
The tools have been tested but not thoroughly, and the server is in active development.
What transport does the server use?
The server is configured to run as a local MCP server via stdio (command-line interface). No network transports are mentioned.
Basic information
More Memory & Knowledge MCP servers
Obsidian MCP Server
cyanheadsRead, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.
Notion MCP Server
awkoyNotion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.
Zettelkasten MCP Server
entanglrA Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
Solomd
zhitongblogA markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
Notion MCP Integration
danhilseA simple MCP integration that allows Claude to read and manage a personal Notion todo list
Comments