home / mcp / obsidian mcp server

Obsidian MCP Server

Provides access to Obsidian vault notes for search, read, and write operations via MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kazuph-mcp-obsidian": {
      "command": "tsx",
      "args": [
        "/path/to/mcp-obsidian/index.ts"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_VAULT_PATH"
      }
    }
  }
}

You can connect Claude Desktop and other MCP clients to your Obsidian vault to search, read, and manage your notes directly from your preferred interface. This MCP Obsidian server lets you access your Obsidian notes through a standard MCP workflow, enabling fast queries and note retrieval while keeping your vault data under your control.

How to use

Use this MCP server with an MCP client by configuring the client to launch the Obsidian integration tool and point it at your Obsidian vault. You can read notes, search by note name, list directory structures, and create new notes through the available tool endpoints. Ensure your Obsidian vault is accessible by the client, and provide the vault path via the OBSIDIAN_VAULT_PATH environment variable.

How to install

Prerequisites you need before you begin are: - Node.js 18+ - An Obsidian vault - Claude Desktop installed and running - Optionally, tsx if you plan to run the TypeScript entry directly via MCP tooling.

# Clone the project
git clone https://github.com/kazuph/mcp-obsidian.git
cd mcp-obsidian

# Install dependencies
npm install

# Build the project
npm run build

# Optionally install tsx globally if you want to run TypeScript entry directly
npm install -g tsx
# or
pnpm add -g tsx

Additional configuration and tips

Configure Claude Desktop to run the Obsidian MCP tools by editing your Claude Desktop configuration. You will add an Obsidian tool entry that launches the MCP client via npx or via tsx, and you will provide the vault path as an environment variable.

{
  "tools": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Security, notes, and troubleshooting

Keep your vault path private and only expose it to trusted MCP clients. If you encounter issues with vault access, verify that OBSIDIAN_VAULT_PATH correctly points to your Obsidian vault and that the client process has permission to read the vault directory.

Available tools

obsidian_read_notes

Read the contents of multiple notes; each note is returned with its path for reference.

obsidian_search_notes

Search notes by name with case-insensitive matching, supporting partial and regex queries.

obsidian_read_notes_dir

List the directory structure under a specified path within the vault.

obsidian_write_note

Create a new note at the specified path in the vault.