Obsidian MCP Server

Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.

Local serverstdio★ 311

What is the Obsidian MCP Server?

Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.

The short version

This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.

  • 🔗 Seamless Obsidian Integration — Direct access to Obsidian knowledge bases through MCP protocol
  • 📝 Complete Note Management — Read, create, update, and delete notes with advanced text replacement
  • 📁 Folder Operations — Create, rename, move, and delete folders with full hierarchy support
  • 🔍 Intelligent Search — Full-text search across all file types with smart scoring
  • 🤖 AI-Powered Analysis — NEW Strategic insights using TRILEMMA-PRINCIPLES framework
  • 🔗 Auto Backlink Generation — NEW Intelligent detection and conversion of note names to wikilinks

What it needs from you

  • Node.js (v16 or higher) - Obsidian desktop application - Obsidian Local REST API plugin (needs to be installed in Obsidian)

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
list_notesList notes in the Obsidian vault with optional folder filtering
read_noteRead the content of a specific note in the Obsidian vault
read_multiple_notesRead content from multiple notes simultaneously for batch processing
create_noteCreate a new note in the Obsidian vault with full content
delete_noteDelete a note from the Obsidian vault
search_vaultAdvanced search across all file types with filename and content matching
move_noteMove or rename notes to new locations (supports all file types including PDFs)
manage_folderComplete folder CRUD operations (create/rename/move/delete)
update_noteEnhanced Update content using text replacements OR precision insertion
auto_backlink_vault🔗 Auto Backlink Generation
notes_insight🧠 AI-Powered Strategic Analysis ⭐ NEW
AIdriven content summarization for context optimization

How to install the Obsidian MCP Server

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "@huangyihe/obsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "YOUR_OBSIDIAN_API_TOKEN",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js (v16 or higher) - Obsidian desktop application - Obsidian Local REST API plugin (needs to be installed in Obsidian)
VariableDescriptionRequired
OBSIDIAN_VAULT_PATHDeclared in the maintainer’s client configuration.Check documentation
OBSIDIAN_API_TOKENDeclared in the maintainer’s client configuration.Check documentation
OBSIDIAN_API_PORTDeclared in the maintainer’s client configuration.Check documentation

Frequently asked questions

You can enable AI models to read, create, update, and delete notes, manage folders, and perform full-text searches within your Obsidian vault.