Obsidian MCP Server

@StevenStavrakis

代码仓库

基本信息

分类

记忆与知识

许可证

MIT

传输方式

stdio

作者

StevenStavrakis

关于 Obsidian MCP Server

A simple MCP server for Obsidian

#obsidian #mcp #note-management

Obsidian MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/path/to/your/vault"
      ]
    }
  }
}

Obsidian MCP Server 工具

Read the contents of a note

Create a new note

Edit an existing note

Delete a note

Move a note to a different location

Create a new directory

Search notes in the vault

Add tags to a note

Remove tags from a note

Rename a tag across all notes

List and organize tags

List all available vaults (helps with multi-vault setups)

概览

What is 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. It is designed for Obsidian users who want to let AI assistants directly manage their note-taking vault.

How to use Obsidian MCP Server?

Install manually by adding the server to your Claude Desktop configuration file, specifying the absolute path(s) to your Obsidian vault(s). The server runs via npx obsidian-mcp <vault-path>. A Smithery installation option is available but not recommended by the author. Requires Node.js 20 or higher.

Key features of Obsidian MCP Server

Read and search notes in your vault
Create new notes and directories
Edit and delete existing notes
Move notes between locations
Manage tags (add, remove, rename)
Support for multiple vaults

Use cases of Obsidian MCP Server

AI assistant reads and summarises notes from your vault
Automatically create, organise, or update notes via prompts
Bulk tag management across multiple notes
Move or restructure notes within the vault

常见问题

What backup is recommended before using Obsidian MCP Server?

The README strongly advises backing up your Obsidian vault prior to use, recommending git or any backup method, because the server has read and write access and is in active development.