Obsidian MCP REST Server

What is Obsidian MCP REST Server?

The Obsidian MCP REST Server is an MCP (Model Context Protocol) server implementation that provides access to Obsidian vaults through a local REST API. It allows AI assistants to interact with Obsidian notes and manage vault content via a standardized interface.

How to use Obsidian MCP REST Server?

Install the package globally with npm install -g PublikPrinciple/obsidian-mcp-rest. Create a config.json file with your Obsidian Local REST API key, host, and port (default 27123), then start the server with obsidian-mcp-rest --config path/to/config.json. For Claude Desktop, add a server configuration in its MCP section using the same command and arguments.

Key features of Obsidian MCP REST Server

• Access Obsidian vault contents through MCP
• Read and write notes
• List vault contents
• Search functionality
• Secure local REST API integration
• Compatible with Claude Desktop and other AI assistants

Use cases of Obsidian MCP REST Server

• An AI assistant reads a specific note from the vault
• List all notes in a given folder
• Search for notes containing a keyword
• Create or update a note via AI command
• Retrieve metadata for a note

FAQ from Obsidian MCP REST Server

What are the prerequisites for using Obsidian MCP REST Server?

You need Node.js 16 or higher, an Obsidian vault with the Local REST API plugin installed and configured, and a valid API key.

How secure is Obsidian MCP REST Server?

The server only runs locally, communicates via stdin/stdout, and requires no external network access. All requests to the Obsidian REST API are authenticated with your API key, keeping data local.

What tools does Obsidian MCP REST Server provide?

It provides five tools: listNotes (list notes/vault), readNote (read note content), writeNote (create/update note), searchNotes (search by query), and getMetadata (get note metadata).

Can I install Obsidian MCP REST Server if the global npm install fails?

Yes. Clone the repository, install dependencies, build, and then run npm install -g . to install globally, or resolve TypeScript errors by installing TypeScript globally.

How do I configure Obsidian MCP REST Server for Claude Desktop?

In Claude Desktop settings, navigate to the MCP section and add a server configuration with "name": "obsidian-mcp", "command": "obsidian-mcp-rest", and "args": ["--config", "path/to/config.json"].