Last updated
March 16, 2026
MCP profile
Github OleksandrKucherenko Mcp Obsidian Via Rest
MCP Server for Obsidian Vault Access via Local REST API
Developer ToolsPackageJavaScript/TypeScriptOpen SourceExternal
Visibility
Public
ByRegistry
About This MCP Server
This MCP server exposes the following tools and resources to AI assistants:
For other CLI tools (Gemini, OpenCode, Kilo Code, Copilot), see Manual Testing Guide.
The MCP server supports HTTP transport for remote access with automatic URL failover:
Clients must include the Authorization header:
For local development with stdio transport (default):
For backward compatibility, you can still use single-URL configuration with API_HOST and API_PORT:
When HTTP transport is enabled, the server exposes a health check endpoint at /health:
For comprehensive health status including Obsidian API connection and all transports, you can use the getHealthStatus() function which returns:
This section shows how to configure popular AI CLI tools to use the MCP Obsidian server.
Create opencode.json in your project root:
Create .kilocode/mcp.json in your project or ~/.kilocode/cli/global/settings/mcp_settings.json globally:
Create ~/.copilot/mcp-config.json (or .copilot/mcp-config.json in repo root):
For detailed testing and verification, see Manual Testing Guide.
This setting will allow you to connect to the Local REST API from any network interface (not only localhost, which is critical for WSL2 setup).
Run in Windows CMD terminal:
Expected REST API response:
Run inside the WSL2 Ubuntu Terminal:
Run GUI and Setup Manual The Rules:
Or Run in Windows PowerShell as Administrator:
Or Run in Windows CMD terminal:
Execute in Windows PowerShell as Administrator:
Tools & Endpoints1
Specifications
Status
live
Industry
Developer Tools
Category
General
Server type
Package
Language
JavaScript/TypeScript
License
Open Source
Verified
Yes
Hosting
Hosting Options
- Package
API
Integrate this server into your application. Choose a connection method below.
1
Configure
Configuration
json
{
"mcpServers": {
"obsidian": {
"command": "docker",
"args": [
"run",
"--name", "mcp-obsidian",
"--rm",
"-i", // Keep STDIN open for stdio transport
"-p", "3000:3000",
"-e", "API_KEY",
"-e", "API_URLS",
"-e", "DEBUG", // for logs
"ghcr.io/oleksandrkucherenko/obsidian-mcp:latest"
],
"env": {
"API_KEY": "<secret_key>",
// JSON array - automatically tests and selects fastest URL
"API_URLS": "[\"https://127.0.0.1:27124\",\"https://172.26.32.1:27124\",\"https://host.docker.internal:27124\"]",
"DEBUG": "mcp:*"
}
}
}
}Performance
Usage
Quick Reference
- Name
- Github OleksandrKucherenko Mcp Obsidian Via Rest
- Function
- MCP Server for Obsidian Vault Access via Local REST API
- Available Tools
- This MCP server exposes the following tools and resources to AI assistants:
- Transport
- Package
- Language
- JavaScript/TypeScript
- Source
- External (Registry)
- License
- Open Source
Get started
Ready to integrate this MCP server?
Book a demo to see how this server fits your workflow, or explore the full catalog.