obsidian/obsidian

MCP Server

Obsidian MCP Server - read, create, search notes in Obsidian vault

Obsidian vault MCP server. Read, create, search, and manage notes with backlink generation and folder operations.

MCP Server

  • Package: @huangyihe/obsidian-mcp
  • Transport: stdio
  • Command: npx @huangyihe/obsidian-mcp

Authentication

API Token (from Obsidian Local REST API plugin)

VariableRequiredDescription
OBSIDIAN_VAULT_PATHYesPath to Obsidian vault
OBSIDIAN_API_TOKENYesToken from Local REST API plugin
OBSIDIAN_API_PORTNoAPI port (default: 27123)

Available Tools

ToolDescription
list_notesList notes
read_noteRead note
create_noteCreate note
delete_noteDelete note
search_notesFull-text search
manage_foldersFolder operations

Configuration Example

toml
[[mcp.servers]]
name = "obsidian"
type = "stdio"
command = "npx"
args = ["-y", "@huangyihe/obsidian-mcp"]
timeout_seconds = 60
env = { OBSIDIAN_VAULT_PATH = "your-value", OBSIDIAN_API_TOKEN = "your-value", OBSIDIAN_API_PORT = "your-value" }
tools = []

Notes: Requires Obsidian Local REST API community plugin installed and running.