Skip to main content
Glama
LPFchan

obsidian-mcp

by LPFchan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

obsidian-mcp

Single-container MCP server for an Obsidian vault. It handles CORS and exposes 15 vault-management tools. Production authentication is centralized in the Common Auth gateway.

Protocol

The server uses the official MCP TypeScript SDK v2. Its HTTP endpoint serves the 2026-07-28 stateless protocol through server/discover and keeps a stateless legacy fallback for clients that still use the initialize handshake. Tool registration and protocol validation remain in the SDK.

Related MCP server: Vault Cortex Obsidian MCP Server

Quick start

docker run -d --name mcp \
  -p 127.0.0.1:3000:3000 \
  -v /path/to/your/vault:/vault \
  -e VAULT_PATH=/vault/Obsidian\ Vault \
  ghcr.io/lpfchan/mcp

Or with docker-compose:

services:
  mcp:
    build: .
    container_name: mcp
    ports:
      - 127.0.0.1:3000:3000
    environment:
      - VAULT_PATH=/vault/Obsidian Vault
    volumes:
      - ./vault:/vault

Configuration

Variable

Default

Description

VAULT_PATH

(required)

Path to the Obsidian vault inside the container

PORT

3000

HTTP listen port

ALLOWED_ORIGIN

https://chat.lost.plus

CORS allowed origin

HOST

127.0.0.1

Bind address; Compose explicitly uses 0.0.0.0 inside the container

The production endpoint is https://mcp.lost.plus/mcp. The shared Common Auth gateway protects it with the obsidian scope. Send a Common Auth token as Authorization: Bearer <token> or X-API-Key: <token>. The backend does not authenticate requests itself and must remain bound to localhost behind the gateway. Tokens in URL paths are no longer supported.

Tools

Tool

Description

list-available-vaults

Lists available vault names

read-note

Reads a note's content

create-note

Creates a new note

edit-note

Edits a note (append, prepend, overwrite, or targeted replace)

search-vault

Searches content, filenames, or tags (with fuzzy mode)

list-notes

Lists all .md files with optional stats

move-note

Moves or renames a note

create-directory

Creates a directory in the vault

delete-note

Moves a note to .trash

add-tags

Adds tags to frontmatter

remove-tags

Removes tags from frontmatter

rename-tag

Renames a tag across all notes

delete-directory

Permanently deletes a directory

open-trash

Lists files in .trash

recover-from-trash

Recovers a file from .trash

Testing

npm install
npm test

61 tests across 23 suites covering every tool, protocol negotiation, auth, CORS, and edge cases.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • obsidian-mcp-complete

    jagoff
    A
    license
    B
    quality
    D
    maintenance
    Local-first MCP server for Obsidian vaults with 66 tools for reading, writing, searching, and managing notes, tasks, graphs, and more. Works without Obsidian running and requires no plugins.
    66
    MIT

  • Vault Cortex Obsidian MCP

    aliasunder
    A
    license
    A
    quality
    A
    maintenance
    Standalone MCP server for Obsidian vaults - hybrid search (FTS5 + vector + cross-encoder reranking), images and PDFs in agent-readable form, Kanban-aware tasks (Tasks-plugin + Dataview formats), structured memory with topic recall, fine-grained read/write tools for optimal token efficiency, and link graph support. Run locally, self-host, or one-click deploy for remote access. OAuth 2.1.
    33
    126 npm
    21
    MIT

  • mcp-obsidian

    kyleect
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for interacting with Obsidian via the Local REST API, enabling file operations, search, and content editing in your vault.
    MIT

  • vault-mcp-server

    KauaLealz
    F
    license
    C
    quality
    C
    maintenance
    MCP server to query and modify an Obsidian vault or any folder of markdown files. It provides search, tag filtering, backlinks, and CRUD operations on notes, with path traversal protection.
    11
    -