Obsidian MCP Server

Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.

Remote serverstreamable-httpTypeScript

What is the Obsidian MCP Server?

Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.

What you get

Give any AI agent access to your Obsidian vault over MCP. Run it locally against your vault files, or pair it with Self-hosted LiveSync and deploy to the cloud so it works even when your machine is off.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
read_noteRead a note's markdown content by path
write_noteCreate or overwrite a note (replaces entire content)
edit_noteEdit a note without rewriting it — append, prepend (after frontmatter), or replace exact text
list_foldersList all folders in the vault with note counts — use to discover folder names
list_tagsList all tags in the vault with counts — use to discover tags before filtering
list_notesList notes with timestamps. Filter by folder, name, tag, or date. Sort by name or modified.
delete_noteDelete a note
move_noteMove or rename a note — works across folders, creates destination folders automatically
get_note_metadataGet frontmatter, tags, outgoing links, backlinks, size, and timestamps — navigate the knowledge graph

How to install the Obsidian MCP Server

{
  "mcpServers": {
    "obsidian-sync": {
      "command": "npx",
      "args": ["-y", "obsidian-sync-mcp"],
      "env": {
        "COUCHDB_URL": "your-value",
        "MCP_AUTH_TOKEN": "your-value",
        "BASE_URL": "your-value",
        "VAULT_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
COUCHDB_URLEndpoint or connection string the server talks to.Yes
MCP_AUTH_TOKENCredential the server authenticates with.Yes
BASE_URLEndpoint or connection string the server talks to.Yes
VAULT_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Obsidian to read note.”
  • “Use Obsidian to write note.”
  • “Use Obsidian to edit note.”

Frequently asked questions

Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.