obsidian-mcp

community

(by Steven Stavrakis) An MCP server for Obsidian.md with tools for searching, reading, writing, and organizing notes.

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

{
    "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:

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:

npx -y @smithery/cli install obsidian-mcp --client claude

Development

# 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"]
        }
    }
}

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
- Verify your configuration file syntax
- Make sure the vault path is absolute and exists
- Restart Claude Desktop
Permission errors
- Ensure the vault path is readable/writable
- Check file permissions in your vault
Tool execution failures
- Check Claude Desktop logs at:
  - macOS:
```
~/Library/Logs/Claude/mcp*.log
```
  - Windows:
```
%APPDATA%\Claude\logs\mcp*.log
```

License

MIT

Related Servers

Brave Search

reference

Web and local search using Brave's Search API

View Details

Git

reference

Tools to read, search, and manipulate Git repositories

View Details

Google Drive

reference

File access and search capabilities for Google Drive

View Details

Aiven

official

Navigate your [Aiven projects](https://go.aiven.io/mcp-server) and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services

View Details

Apify

official

[Actors MCP Server](https://apify.com/apify/actors-mcp-server): Use 3,000+ pre-built cloud tools to extract data from websites, e-commerce, social media, search engines, maps, and more

View Details