About Obsidian Mcp
Obsidian Mcp is a Go-based MCP server that connects MCP clients to Obsidian through the Obsidian Local REST API plugin. It provides tools and prompts, with stdio and SSE server modes.
Key features
- 01Obsidian REST API integration
- 02MCP tools and prompts
- 03stdio and SSE modes
Use cases
- 01Access Obsidian through an MCP client
- 02Use Obsidian notes in MCP workflows
MCP support
Exposes Obsidian interaction through MCP tools and prompts. It connects to the Obsidian Local REST API and supports stdio or SSE mode.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEobsidian-mcp
A Model Context Protocol (MCP) server for Obsidian, written in Go.
Features
- Interact with Obsidian through the MCP protocol
- Support for Obsidian REST API
- Provides tools and prompts functionality
- Supports both stdio and SSE server modes
Prerequisites
This MCP server requires the Obsidian Local REST API plugin to be installed and enabled in Obsidian. This plugin provides a secure HTTPS interface that allows external tools to interact with your Obsidian notes through a REST API.
Installation
Using go install
go install github.com/orvice/obsidian-mcp/cmd/obsidian-mcp@latest
Build from source
git clone https://github.com/orvice/obsidian-mcp.git
cd obsidian-mcp
go build -o obsidian-mcp ./cmd/obsidian-mcp
Configuration
Environment Variables
OBSIDIAN_BASE_URL: Base URL for Obsidian REST APIOBSIDIAN_API_KEY: API key for Obsidian REST APISSE_SERVER: Set to "true" to enable SSE server mode (optional)
MCP Configuration Examples
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"obsidian-mcp": {
"command": "obsidian-mcp",
"env": {
"OBSIDIAN_BASE_URL": "http://localhost:27123",
"OBSIDIAN_API_KEY": "your-obsidian-api-key"
}
}
}
}
Continue Configuration
Add to ~/.continue/config.json:
{
"experimental": {
"modelContextProtocol": true
},
"mcpServers": {
"obsidian-mcp": {
"command": "obsidian-mcp",
"args": [],
"env": {
"OBSIDIAN_BASE_URL": "http://localhost:27123",
"OBSIDIAN_API_KEY": "your-obsidian-api-key"
}
}
}
}
Usage
- Ensure Obsidian is installed with the REST API plugin enabled
- Obtain an API key and configure environment variables
- Start the MCP server
- Use in MCP-compatible clients (such as Claude Desktop)
Development
# Run the project
go run ./cmd/obsidian-mcp
# Run tests
go test ./...
# Build
make build
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.