Advertise
MCP.so
Sign In

Obsidian MCP Server

@roelven

Repository

Basic information

Category

Memory & Knowledge

License

MIT license

Transports

stdio

Author

roelven

About Obsidian MCP Server

MCP (Model Context Protocol) server for Obsidian notes access via CouchDB LiveSync

#obsidian#mcp-server#couchdb

Obsidian MCP Server config

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

{
  "mcpServers": {
    "obsidian-mcp-server-roelven": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "obsidian-mcp-server",
        "."
      ]
    }
  }
}

Obsidian MCP Server 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 Obsidian MCP Server?

A Model Context Protocol (MCP) server that gives AI models read-only access to your Obsidian notes by connecting through your existing LiveSync CouchDB setup. It is intended for users who want to query, search, and browse their Obsidian vault programmatically via MCP clients like Claude Desktop.

How to use Obsidian MCP Server?

Install via Docker (recommended) or run locally with Python 3.10+. Configure required environment variables (COUCHDB_BASE_URL, COUCHDB_DATABASE_NAME, COUCHDB_USER, COUCHDB_PASSWORD, API_KEY) in a .env file. Start the server with obsidian-mcp-server --transport stdio for direct MCP client connections or --transport sse --port 8000 for HTTP-based access. Integrate with clients like Claude Desktop by adding a mcpServers entry that runs the Docker image with the .env file.

Key features of Obsidian MCP Server

  • Read-only access to Obsidian notes via LiveSync CouchDB
  • Performance-optimized resource listing (10 recent notes)
  • Automatic content inclusion for small result sets (≤3 notes)
  • Metadata extraction: frontmatter, tags, and aliases
  • Reassembles chunked notes automatically
  • Supports encrypted vaults (if VAULT_PASSPHRASE is set)
  • Docker support and full environment variable configuration

Use cases of Obsidian MCP Server

  • AI assistants answering questions by searching your Obsidian notes
  • Browsing recent notes sorted by modification, creation time, or path
  • Quickly retrieving the most recent note with full content
  • Integrating with Claude Desktop to query your vault without direct file access
  • Searching notes by title, content, or tags from any MCP‑compatible client

Frequently asked questions

1

What prerequisites are needed?

A running Obsidian LiveSync CouchDB instance with read‑access credentials, plus Python 3.10+ (local) or Docker.

2

Can Obsidian MCP Server read encrypted notes?

Yes. Set the `VAULT_PASSPHRASE` environment variable to decrypt encrypted Obsidian LiveSync notes. If not set, encrypted notes will not be decrypted.

3

Does Obsidian MCP Server support write operations?

No. The server provides read‑only access to your notes for safety. Write operations are listed as a future enhancement.

4

What transport protocols are available?

The server supports two MCP transports: `stdio` (direct client connection) and `SSE` (HTTP‑based on a configurable port, default 8000).

5

How can I improve query performance?

Create a JSON index on the `type` and `mtime` fields in your LiveSync CouchDB database. This index is recommended for efficient listing and sorting of notes.

Comments

More Memory & Knowledge MCP servers

Azquo

Azquo Holdings Ltd

Exact, shared memory for AI agents: a hierarchical database where totals always add up, every write is attributed to the agent and person behind it, and any figure traces back to its source file. Agents create databases,

Agimem

Persistent memory for AI agents. Hosted MCP server with capsule-scoped key/value storage, tags, TTL expiration, bulk ops, and RBAC.

Snipara

alopez3006

MCP connector for Snipara, the Project Brain for AI coding agents

1

Sensefold

SenseFold Labs

Personal context for every AI: search, read, and write back to your private Markdown library of articles, threads, PDFs, notes, and captured ChatGPT/Claude/Gemini/Grok conversations. Remote server, OAuth 2.1 paste-and-au

HandbookHub MCP

veryayskiy

Search saved employee handbooks from your AI assistant. Four read-only tools list authorized handbooks, browse policies, search content, and read source pages with citation links. Uses scoped bearer tokens and Streamable

Advertise