MCPgee
MCPgee
MCPgeeMCPgee

Obsidian

v1.0.0•Knowledge & Memory•stable

Dockerized version of MCP Obsidian server for Obsidian Local REST API integration

mcp-obsidian-dockermcpai-integration
Share:
8
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Obsidian?

Obsidian is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to dockerized version of mcp obsidian server for obsidian local rest api integration

Dockerized version of MCP Obsidian server for Obsidian Local REST API integration

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Dockerized version of MCP Obsidian server for Obsidian Local

Use Cases

Access Obsidian notes and vaults through Claude via REST API.
Manage knowledge base and interconnected notes.
kmackett

Maintainer

LicenseMIT
Languagedockerfile
Versionv1.0.0
UpdatedMar 26, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-obsidian-docker

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Obsidian

MCP Obsidian Docker is a Dockerized MCP server that bridges Claude with your Obsidian vault via the Obsidian Local REST API plugin. It lets Claude read, search, create, and update notes directly in your vault running locally, without exposing your notes to any cloud service beyond your own machine.

Prerequisites

  • Docker and Docker Compose installed
  • Obsidian desktop app with the Local REST API community plugin enabled
  • API key generated from the Local REST API plugin settings in Obsidian
  • Git to clone the repository
  • Claude Desktop installed
1

Install the Obsidian Local REST API plugin

Open Obsidian, go to Settings → Community Plugins, disable Safe Mode, browse for 'Local REST API', install it, and enable it. Then open its settings pane and copy the generated API key.

2

Clone the mcp-obsidian-docker repository

Clone the repository to your local machine. It contains the Docker Compose file and the MCP server source code.

git clone https://github.com/kmackett/mcp-obsidian-docker.git
cd mcp-obsidian-docker
3

Configure the environment file

Copy the provided example env file and fill in your Obsidian Local REST API key. The server reads this at startup.

cp .env.example .env
# Edit .env and set:
# OBSIDIAN_API_KEY=your_api_key_from_plugin
4

Start the Docker container

Start the MCP server container in the background using Docker Compose. The server will listen on port 27124, which must match the port configured in the Obsidian Local REST API plugin.

docker-compose up -d
5

Add the server to Claude Desktop configuration

Configure Claude Desktop to connect to the running Docker-based MCP server. The server runs as an HTTP service, so the command points to the container endpoint.

{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-obsidian-docker", "node", "dist/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "your_api_key_here"
      }
    }
  }
}
6

Verify the container and connection

Check that the container is running and review logs for any errors before testing from Claude.

docker-compose ps
docker-compose logs -f

Obsidian Examples

Client configuration

claude_desktop_config.json entry using the Docker-based Obsidian MCP server with your API key.

{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-obsidian-docker", "node", "dist/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "your_obsidian_local_rest_api_key"
      }
    }
  }
}

Prompts to try

Example prompts to interact with your Obsidian vault through Claude once the server is connected.

- "Search my Obsidian vault for notes about project planning"
- "Show me the content of my Daily Notes/2024-01-15.md note"
- "Create a new note called Meeting Summary with today's action items"
- "List all notes in my Projects folder"
- "Update my Tasks note and add a new item: Review MCP server setup"

Troubleshooting Obsidian

Docker container exits immediately after starting

Run docker-compose logs to see the error. The most common cause is a missing or incorrect OBSIDIAN_API_KEY in the .env file. Ensure .env exists and the key matches what the Obsidian plugin shows.

Claude cannot connect to the Obsidian server (connection refused)

Confirm the Local REST API plugin is enabled in Obsidian and that Obsidian is running. The plugin must be active and listening before the MCP server can forward requests. Default port is 27124.

Restarting the container after changing the API key has no effect

Run docker-compose restart rather than just stopping the container. If still not updated, run docker-compose down && docker-compose up -d to force a full restart with the new environment.

Frequently Asked Questions about Obsidian

What is Obsidian?

Obsidian is a Model Context Protocol (MCP) server that dockerized version of mcp obsidian server for obsidian local rest api integration It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Obsidian?

Follow the installation instructions on the Obsidian GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Obsidian?

Obsidian works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Obsidian free to use?

Yes, Obsidian is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Obsidian Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Obsidian? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-obsidian-docker": { "command": "npx", "args": ["-y", "mcp-obsidian-docker"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Obsidian?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides