Obsidian MCP REST Server

An MCP server implementation for accessing Obsidian via local REST API

Catalog onlyCatalog onlySTDIO

Overview

Obsidian MCP REST Server is a server implementation for accessing Obsidian vaults via a local REST API, enabling AI assistants to manage and interact with notes through a standardized interface.

To use the server, you need to install it and configure your Obsidian Local REST API plugin. After setting up the configuration file, you start the server and can make REST API calls to manage your notes.

Access to Obsidian vault contents through the Model Context Protocol (MCP) - Ability to read and write notes - Listing of vault contents - Powerful search functionality - Secure local API integration - Compatibility with Claude Desktop and other AI assistants

Automating note management with AI assistants like Claude Desktop.
Integrating Obsidian vault contents with other applications through REST.
Accessing and managing notes programmatically for software development or personal projects.

Add to your AI client

Use these steps to connect Obsidian MCP REST Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-rest-publikprinciple": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "obsidian-mcp-rest-publikprinciple": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "obsidian-mcp-rest-publikprinciple": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "obsidian-mcp-rest-publikprinciple": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-rest-publikprinciple": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "obsidian-mcp-rest-publikprinciple": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-rest-publikprinciple"
      ]
    }
  }
}

Developer tools

Obsidian MCP REST Server — MCP Registry