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.
Warning!!!
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.
Features
- Read and search notes in your vault
- Create new notes and directories
- Edit existing notes
- Move and delete notes
- Manage tags (add, remove, rename)
- Search vault contents
Requirements
- Node.js 20 or higher (might work on lower, but I haven't tested it)
- An Obsidian vault
Install
Installing Manually
Add to your Claude Desktop configuration:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Replace
/path/to/your/vault with the absolute path to your Obsidian vault. For example:MacOS/Linux:
Windows:
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:
- MacOS:
~/Library/Logs/Claude/mcp*.log
- Windows:
%APPDATA%\Claude\logs\mcp*.log
Installing via Smithery
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:
Development
Then add to your Claude Desktop configuration:
Available Tools
read-note- Read the contents of a note
create-note- Create a new note
edit-note- Edit an existing note
delete-note- Delete a note
move-note- Move a note to a different location
create-directory- Create a new directory
search-vault- Search notes in the vault
add-tags- Add tags to a note
remove-tags- Remove tags from a note
rename-tag- Rename a tag across all notes
manage-tags- List and organize tags
list-available-vaults- List all available vaults (helps with multi-vault setups)
Documentation
Additional documentation can be found in the
docs directory:creating-tools.md- Guide for creating new tools
tool-examples.md- Examples of using the available tools
Security
This server requires access to your Obsidian vault directory. When configuring the server, make sure to:
- Only provide access to your intended vault directory
- Review tool actions before approving them
Troubleshooting
Common issues:
- Server not showing up in Claude Desktop
- Permission errors
- Tool execution failures
License
MIT
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.
Warning!!!
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.
Features
- Read and search notes in your vault
- Create new notes and directories
- Edit existing notes
- Move and delete notes
- Manage tags (add, remove, rename)
- Search vault contents
Requirements
- Node.js 20 or higher (might work on lower, but I haven't tested it)
- An Obsidian vault
Install
Installing Manually
Add to your Claude Desktop configuration:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Replace
/path/to/your/vault with the absolute path to your Obsidian vault. For example:MacOS/Linux:
Windows:
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:
- MacOS:
~/Library/Logs/Claude/mcp*.log
- Windows:
%APPDATA%\Claude\logs\mcp*.log
Installing via Smithery
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:
Development
Then add to your Claude Desktop configuration:
Available Tools
read-note- Read the contents of a note
create-note- Create a new note
edit-note- Edit an existing note
delete-note- Delete a note
move-note- Move a note to a different location
create-directory- Create a new directory
search-vault- Search notes in the vault
add-tags- Add tags to a note
remove-tags- Remove tags from a note
rename-tag- Rename a tag across all notes
manage-tags- List and organize tags
list-available-vaults- List all available vaults (helps with multi-vault setups)
Documentation
Additional documentation can be found in the
docs directory:creating-tools.md- Guide for creating new tools
tool-examples.md- Examples of using the available tools
Security
This server requires access to your Obsidian vault directory. When configuring the server, make sure to:
- Only provide access to your intended vault directory
- Review tool actions before approving them
Troubleshooting
Common issues:
- Server not showing up in Claude Desktop
- Permission errors
- Tool execution failures
License
MIT