Obsidian Enhanced MCP Server

Obsidian Knowledge-Management MCP (Model Context Protocol) server that enables AI agents and development tools to interact with an Obsidian vault. It

Remote serverstreamable-httpTypeScript

What is the Obsidian Enhanced MCP server?

Obsidian Enhanced MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. Obsidian Knowledge-Management MCP (Model Context Protocol) server that enables AI agents and development tools to interact with an Obsidian vault. It provides a comprehensive suite of tools for reading, writing, searching, and managing.

What you get

An MCP (Model Context Protocol) server providing comprehensive access to your Obsidian vault. Enables LLMs and AI agents to read, write, search, and manage your notes and files through the Obsidian Local REST API plugin.

The Obsidian MCP Server acts as a bridge, allowing applications (MCP Clients) that understand the Model Context Protocol (MCP) – like advanced AI assistants (LLMs), IDE extensions, or custom scripts – to interact directly and safely with your Obsidian vault.

What the assistant can call

Once Obsidian Enhanced is connected, these are the calls the assistant has available:

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

You will need 8 environment variables: MCP_AUTH_KEY, OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, OBSIDIAN_VAULTS, OBSIDIAN_ENABLE_CACHE, CHATGPT_FACADE_PUBLIC_URL, CHATGPT_FACADE_ADMIN_SECRET, MCP_HTTP_HOST. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  1. Obsidian: You need Obsidian installed. 2. Obsidian Local REST API Plugin: Install and enable the Obsidian Local REST API plugin within your Obsidian vault. 3. API Key: Configure an API key within the Local REST API plugin settings in Obsidian. You will need this key to configure the server. 4. Node.js & npm: Ensure

Choosing this one

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Obsidian Enhanced's toolset — Case, Prerequisites, Installation — is a fair guide to whether it matches your workflow. It is maintained by BoweyLou; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the obsidian enhanced mcp server does with a few real requests.

Available tools

ToolWhat it does
Caseinsensitive path fallback.
PrerequisitesThe Prerequisites tool exposed by this server.
Installation1. Clone this enhanced repository: bash git clone https://github.com/BoweyLou/obsidian-mcp-server-enhanced.git cd obsidian-mcp-server-enhanced 2. Install dependencies: bash npm install 3. Build the project: bash npm run

How to install the Obsidian Enhanced MCP server

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/obsidian-mcp-server-enhanced/dist/index.js"],
      "env": {
        "MCP_AUTH_KEY": "your-generated-mcp-auth-key",
        "OBSIDIAN_API_KEY": "your-obsidian-api-key",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_ENABLE_CACHE": "true"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  1. Obsidian: You need Obsidian installed. 2. Obsidian Local REST API Plugin: Install and enable the Obsidian Local REST API plugin within your Obsidian vault. 3. API Key: Configure an API key within the Local REST API plugin settings in Obsidian. You will need this key to configure the server. 4. Node.js & npm: Ensure
VariableDescriptionRequired
MCP_AUTH_KEYCredential the server authenticates with.Yes
OBSIDIAN_API_KEYCredential the server authenticates with.Yes
OBSIDIAN_BASE_URLEndpoint or connection string the server talks to.Yes
OBSIDIAN_VAULTSConfiguration value read at startup.Optional
OBSIDIAN_ENABLE_CACHEConfiguration value read at startup.Optional
CHATGPT_FACADE_PUBLIC_URLEndpoint or connection string the server talks to.Yes
CHATGPT_FACADE_ADMIN_SECRETCredential the server authenticates with.Yes
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use Obsidian Enhanced to Case.
  • Use Obsidian Enhanced to Prerequisites.
  • Use Obsidian Enhanced to Installation.

Frequently asked questions

It connects Obsidian Enhanced to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Case, Prerequisites, Installation) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Obsidian Enhanced directly.