obsidian-mcp-server

Overview

This MCP server provides comprehensive functionality for AI assistants to interact with Obsidian vaults. It enables CRUD operations on notes and directories, frontmatter and tag management, full-text search capabilities, and link analysis. The server supports multiple deployment methods including direct npx execution, Docker containers, and local development setups. It implements both SSE and POST endpoints for MCP communication, with optional API key authentication for security.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• read-note

  Read note contents (supports frontmatterOnly for efficiency)

  Try:Read the contents of my meeting notesTry:Get just the frontmatter from my project plan
• create-note

  Create a new note

  Try:Create a new note called 'Project Ideas'Try:Make a new entry for today's journal
• edit-note

  Replace note contents

  Try:Update my project timelineTry:Edit the conclusion section of my research paper
• write-note

  Write with modes: overwrite, append, or prepend

  Try:Add this new information to my existing notesTry:Prepend my note with today's date
• get-frontmatter

  Get YAML frontmatter as JSON

  Try:Show me the frontmatter of my presentationTry:Get the metadata from my blog post
• add-tags

  Add tags to frontmatter or inline

  Try:Tag this note with 'important' and 'todo'Try:Add 'research' and '2023' to my notes
• search-vault

  Full-text search with context

  Try:Find all notes about my marketing strategyTry:Search for references to 'blockchain'
• get-backlinks

  Find notes linking to a note

  Try:Which notes link to my project outline?Try:Find all pages that reference this concept
• find-broken-links

  Find unresolved wiki-links

  Try:Check for broken links in my notesTry:Find all unresolved references in my knowledge base
• list-vault

  List files and directories

  Try:Show me all notes in my projects folderTry:List all directories in my vault
• list-tags

  List all tags with counts

  Try:Show me all tags in my vaultTry:List the most frequently used tags
• find-replace

  Bulk find and replace

  Try:Replace all instances of 'old name' with 'new name'Try:Fix typos in multiple notes at once

Comparable tools

Installation

VAULT_PATH=/path/to/your/vault npx @smith-and-web/obsidian-mcp-server

docker run -d \
  --name obsidian-mcp \
  -v /path/to/your/vault:/vault:rw \
  -p 3001:3000 \
  -e VAULT_PATH=/vault \
  ghcr.io/smith-and-web/obsidian-mcp-server:latest

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3001/sse"]
    }
  }
}

FAQ

Is authentication required?

Authentication is optional. When the API_KEY environment variable is set, all endpoints require authentication via Bearer token or query parameter.

Can I use this with AI assistants other than Claude?

Yes, any MCP-compatible client can connect to this server using the mcp-remote tool or direct connection to the SSE endpoint.

Compare obsidian-mcp-server with