by StevenStavrakis
Enables AI assistants to read, create, edit, move, delete, and organize notes and tags within an Obsidian vault.
It provides a Model Context Protocol (MCP) interface that lets AI assistants interact directly with the file structure of an Obsidian vault, offering read/write capabilities for notes, directories, and tag management.
claude_desktop_config.json
(or another MCP‑compatible client) using the npx
command.read-note
, create-note
, search-vault
, etc.) from the AI assistant.list-available-vaults
tool.Q: Do I need to grant write access? A: Yes. The server can read and write files; always back up your vault before use.
Q: Which operating systems are supported? A: Any OS that can run Node.js 20+ (macOS, Windows, Linux).
Q: Can I use the server with multiple vaults?
A: Absolutely. Provide additional vault paths in the args
array; the list-available-vaults
tool helps manage them.
Q: How do I troubleshoot connection issues?
A: Verify JSON syntax in the Claude config, ensure paths are absolute and existent, and check the log files (~/Library/Logs/Claude/mcp*.log
on macOS or %APPDATA%\Claude\logs\mcp*.log
on Windows).
Q: Is there a way to install via Smithery?
A: Yes, using npx -y @smithery/cli install obsidian-mcp --client claude
, though manual installation is recommended.
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.
This MCP has read and write access (if you allow it). Please. PLEASE backup your Obsidian vault prior to using obsidian-mcp to manage your notes. I recommend using git, but any backup method will work. These tools have been tested, but not thoroughly, and this MCP is in active development.
Add to your Claude Desktop configuration:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
}
}
}
Replace /path/to/your/vault
with the absolute path to your Obsidian vault. For example:
MacOS/Linux:
"/Users/username/Documents/MyVault"
Windows:
"C:\\Users\\username\\Documents\\MyVault"
Restart Claude for Desktop after saving the configuration. You should see the hammer icon appear, indicating the server is connected.
If you have connection issues, check the logs at:
~/Library/Logs/Claude/mcp*.log
%APPDATA%\Claude\logs\mcp*.log
Warning: I am not affiliated with Smithery. I have not tested using it and encourage users to install manually if they can.
To install Obsidian for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install obsidian-mcp --client claude
# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp
# Install dependencies
npm install
# Build
npm run build
Then add to your Claude Desktop configuration:
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
}
}
}
read-note
- Read the contents of a notecreate-note
- Create a new noteedit-note
- Edit an existing notedelete-note
- Delete a notemove-note
- Move a note to a different locationcreate-directory
- Create a new directorysearch-vault
- Search notes in the vaultadd-tags
- Add tags to a noteremove-tags
- Remove tags from a noterename-tag
- Rename a tag across all notesmanage-tags
- List and organize tagslist-available-vaults
- List all available vaults (helps with multi-vault setups)Additional documentation can be found in the docs
directory:
creating-tools.md
- Guide for creating new toolstool-examples.md
- Examples of using the available toolsThis server requires access to your Obsidian vault directory. When configuring the server, make sure to:
Common issues:
Server not showing up in Claude Desktop
Permission errors
Tool execution failures
~/Library/Logs/Claude/mcp*.log
%APPDATA%\Claude\logs\mcp*.log
MIT
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "obsidian": { "command": "npx", "args": [ "-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2" ], "env": {} } } }
Discover more MCP servers with similar functionality and use cases
by topoteretes
Enables AI agents to store, retrieve, and reason over past conversations, documents, images, and audio transcriptions by loading data into graph and vector databases with minimal code.
by basicmachines-co
Basic Memory is a local-first knowledge management system that allows users to build a persistent semantic graph from conversations with AI assistants. It addresses the ephemeral nature of most LLM interactions by providing a structured, bi-directional knowledge base that both humans and LLMs can read and write to.
by smithery-ai
mcp-obsidian is a connector that allows Claude Desktop to read and search an Obsidian vault or any directory containing Markdown notes.
by qdrant
Provides a semantic memory layer on top of the Qdrant vector search engine, enabling storage and retrieval of information via the Model Context Protocol.
by GreatScottyMac
A database‑backed MCP server that stores project decisions, progress, architecture, custom data, and vector embeddings, allowing AI assistants in IDEs to retrieve precise, up‑to‑date context for generation tasks.
by mem0ai
Provides tools to store, retrieve, and semantically search coding preferences via an SSE endpoint for integration with MCP clients.
by graphlit
Enables integration between MCP clients and the Graphlit platform, providing ingestion, retrieval, RAG, and publishing capabilities across a wide range of data sources and tools.
by chroma-core
Provides vector, full‑text, and metadata‑based retrieval powered by Chroma for LLM applications, supporting in‑memory, persistent, HTTP, and cloud clients as well as multiple embedding functions.
by andrea9293
MCP Documentation Server is a TypeScript-based server that provides local document management and AI-powered semantic search capabilities, designed to bridge the AI knowledge gap.