# obsidian-mcp

> MCP Server

This repository provides an MCP server for Obsidian, enabling AI assistants to interact with your vault for reading, creating, editing, and managing notes and tags. Use with caution and back

## Overview

- **Category:** Productivity
- **Language:** TypeScript
- **Stars:** 721
- **Forks:** 13
- **Owner:** StevenStavrakis
- **GitHub:** https://github.com/StevenStavrakis/obsidian-mcp
- **Created:** 2024-12-22T02:54:30+00:00
- **Updated:** 2025-03-28T19:50:07+00:00
- **Source:** https://model-context-protocol.com/servers/obsidian-ai-assistant-note-management-server

## Setup

## Setup

### Installing Manually

Add to your Claude Desktop configuration:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```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:

```json
"/Users/username/Documents/MyVault"
```

Windows:

```json
"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](https://smithery.ai/server/obsidian-mcp):

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

## Development

```bash
# 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:

```json
{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}
```

## Tools

## Available Tools

1.  `read-note` (Read the contents of a note)
2.  `create-note` (Create a new note)
3.  `edit-note` (Edit an existing note)
4.  `delete-note` (Delete a note)
5.  `move-note` (Move a note to a different location)
6.  `create-directory` (Create a new directory)
7.  `search-vault` (Search notes in the vault)
8.  `add-tags` (Add tags to a note)
9.  `remove-tags` (Remove tags from a note)
10. `rename-tag` (Rename a tag across all notes)
11. `manage-tags` (List and organize tags)
12. `list-available-vaults` (List all available vaults, helps with multi-vault setups)