Obsidian MCP

What is Obsidian MCP?

Obsidian MCP is a Model Context Protocol (MCP) server that connects AI models to an Obsidian knowledge base, enabling direct reading, creating, updating, and deleting of notes, as well as folder management.

How to use Obsidian MCP?

Ensure Obsidian is running with the Local REST API plugin installed and configured, then set environment variables (OBSIDIAN_VAULT_PATH, OBSIDIAN_API_TOKEN, OBSIDIAN_API_PORT). Run npm start to launch the server, which communicates with AI models via standard input/output.

Key features of Obsidian MCP

• Seamless integration with Obsidian knowledge bases
• Read, create, update, and delete notes
• Create, rename, move, and delete folders
• Full‑text search within the vault
• Compliant with the Model Context Protocol

Use cases of Obsidian MCP

• AI‑powered note retrieval and editing in Obsidian
• Automated folder organization from AI assistants
• Searching Obsidian notes across the entire vault
• Batch note creation or deletion via AI commands
• Building custom AI workflows with Obsidian as storage

FAQ from Obsidian MCP

What dependencies does Obsidian MCP require?

Node.js v16 or higher, Obsidian Desktop, and the Obsidian Local REST API plugin must be installed and running.

How do I configure the connection to Obsidian?

Set environment variables: OBSIDIAN_VAULT_PATH (vault path), OBSIDIAN_API_TOKEN (API token from the plugin), and OBSIDIAN_API_PORT (default 27123). A .env file can be used and is gitignored.

What tools does Obsidian MCP provide?

It provides seven tools: list_notes, read_note, create_note, update_note, search_vault, delete_note, and manage_folder.

Does Obsidian MCP store any data?

No. The server connects to an existing Obsidian vault via the Local REST API; all data remains in the vault and is not stored externally.

What transport protocol does Obsidian MCP use?

It uses standard input/output (stdio) for communication with AI models, as per the MCP specification.