MCP Obsidian Docker

What is MCP Obsidian Docker?

MCP Obsidian Docker is a containerized version of the MCP Obsidian server that interacts with Obsidian via the Local REST API community plugin. It requires Docker, Docker Compose, and an Obsidian vault with the Local REST API plugin installed and an API key.

How to use MCP Obsidian Docker?

Clone the repository, configure the OBSIDIAN_API_KEY in a .env file, then build and start the container with docker-compose up -d. The server will be available on port 27124. Verify the container with docker-compose ps and inspect logs with docker-compose logs -f.

Key features of MCP Obsidian Docker

• Containerized deployment of MCP Obsidian via Docker Compose
• Requires only the Obsidian Local REST API plugin and an API key
• Environment-based API key configuration using .env file
• Logs stored in a mounted ./logs directory
• Easy restart for API key changes with docker-compose restart

Use cases of MCP Obsidian Docker

• Running the MCP Obsidian server in an isolated Docker container
• Integrating Obsidian with MCP-compatible tools without local Node.js installation
• Automating note creation, search, or content retrieval from Obsidian vaults
• Enabling secure API key management through environment variables

FAQ from MCP Obsidian Docker

How do I get my Obsidian API key?

Open Obsidian, go to Settings → Community Plugins, find “Local REST API,” click its settings gear, and copy the “API Key” field.

How do I set the API key in the container?

Copy .env.example to .env, then edit the file and replace your_api_key_here with your actual API key.

What port does the server use?

The MCP Obsidian server is available at port 27124 by default. If there is a port conflict, modify the port mapping in docker-compose.yml.

How can I check if the container is working?

Run docker-compose ps to see if the container is running, and docker-compose logs -f to view logs for authentication or connection errors.

What if I need to change my API key?

Generate a new key in Obsidian, update the OBSIDIAN_API_KEY in your .env file, and run docker-compose restart.