MCP Obsidian

@OleksandrKucherenko

Basic information

About MCP Obsidian

MCP Server connected to Obsidian Vault with Local REST API. (re-write it completely with BUN to make it faster and more lightweight)

#obsidian#restapi#dockerized#typescript #docker #npm #bun

MCP Obsidian config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "API_KEY",
        "-e",
        "API_URLS",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:latest"
      ],
      "env": {
        "API_KEY": "<your-obsidian-api-key>",
        "API_URLS": "[\"https://host.docker.internal:27124\"]"
      }
    }
  }
}

MCP Obsidian tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-obsidian?

mcp-obsidian is a Model Context Protocol (MCP) server that connects AI assistants to the Obsidian Local REST API, enabling programmatic access to Obsidian notes via a Docker container or local TypeScript runtime.

How to use mcp-obsidian?

Configure the server in your MCP client’s JSON settings with required environment variables (API_KEY, API_HOST, API_PORT). The recommended deployment is via Docker using the image ghcr.io/oleksandrkucherenko/obsidian-mcp:latest. For local development, run bun run src/index.ts with the appropriate config.

Key features of mcp-obsidian

Dockerized deployment with automatic container cleanup (--rm).
Supports WSL2 and Windows host connectivity.
Debug logging via DEBUG=mcp:* environment variable.
Works with the Obsidian Local REST API plugin (v3.2.0).
Pre‑built Docker images for both the MCP server and a full Obsidian‑with‑VNC container.
Cross‑platform compatibility (macOS, Linux, Windows/WSL2).

Use cases of mcp-obsidian

Integrate Obsidian note‑taking with AI‑powered tools (e.g., Claude Desktop, Windsurf).
Automate note creation, search, and content retrieval via MCP.
Test MCP interactions locally without a live Obsidian instance (using the Dockerized Obsidian‑VNC image).

Frequently asked questions

What environment variables are required?

`API_KEY` (your Obsidian Local REST API secret key) is required. `API_HOST` (default `localhost`) and `API_PORT` (default `27124`) are optional.

How do I verify the Obsidian REST API is running?

Run `curl --insecure https://localhost:27124` or use `netstat -an | findstr 27124` on Windows. For WSL2, use the gateway IP (`172.26.32.1` by default).

Does mcp‑obsidian support Windows and WSL2?

Yes. The README provides detailed firewall configuration, gateway IP detection, and connectivity tests for WSL2 with Obsidian running on the Windows host.

What is the default port and host for the Obsidian API?

The default host is `localhost` and the default port is `27124`. Override via `API_HOST` and `API_PORT` environment variables.

Can the server be run without Docker?

Yes, for development you can run `bun run src/index.ts` after installing dependencies with `bun install`. Docker is recommended for production use.

Comments

More Memory & Knowledge MCP servers

Sooveryn

PANDAPROG

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory, and finds them again by words and by meaning, from

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

agentleFS

One permissioned folder your team and your AI agents both log into.

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

priostack

ideaswave

Open-source Python SDK & MCP interface for Priostack Agent Context Network (ACN). Zero-setup, autonomous memory orchestration for AI agents.