Skip to main content
Glama
rupeshpoojary9

obsidian-mcp

by rupeshpoojary9
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

obsidian-mcp

A Model Context Protocol server that exposes an Obsidian (Markdown) vault to any MCP client (Claude Desktop, Claude Code, Cursor). Ask your assistant to search your notes, read a specific note, or list your tags, and it queries the vault directly through typed MCP tools.

Tools

Tool

Description

list_notes

List every Markdown note as vault-relative paths

search_notes(query, limit=20)

Case-insensitive substring search; returns {path, line, snippet} hits

read_note(path)

Read one note by its vault-relative path

list_tags

Every tag in the vault with its count, from frontmatter and inline #tags

All tools are read-only and refuse any path outside the vault root.

Related MCP server: vault-mcp-bridge

Install

git clone https://github.com/<your-username>/obsidian-mcp.git
cd obsidian-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

Configure in an MCP client

Point the client at the server and set VAULT_PATH to your vault root. Example for Claude Desktop (claude_desktop_config.json) or Claude Code:

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "env": { "VAULT_PATH": "/absolute/path/to/your/vault" }
    }
  }
}

Restart the client. Ask it: "search my vault for retrieval" or "list my tags."

Develop

pytest            # run the unit tests
VAULT_PATH=/path/to/vault obsidian-mcp   # run the server on stdio

The core vault logic lives in src/obsidian_mcp/vault.py (pure functions, fully unit-tested) and is kept separate from the MCP wiring in server.py, so the logic can be tested without an MCP client.

Roadmap

  • Write tools (append to a note, create from template) behind an opt-in flag

  • Expose notes as MCP resources and add reusable prompts

  • Streamable-HTTP transport for remote use

  • Tag-filtered and frontmatter-field search

License

MIT

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

    MichaelAnckaert
    A
    license
    A
    quality
    D
    maintenance
    Provides read-only access to an Obsidian vault, enabling file listing, content reading, and text search across notes via MCP.
    4
    2
    Apache 2.0

  • vault-mcp-bridge

    kizz-tech
    A
    license
    Not graded
    quality
    B
    maintenance
    Read-only MCP bridge that exposes secure search and fetch tools over an Obsidian-compatible Markdown vault, enabling ChatGPT to query notes without write access.
    1
    Apache 2.0

  • brain-mcp

    sipho102
    A
    license
    Not graded
    quality
    B
    maintenance
    Serves a PARA-structured, Obsidian-compatible Markdown vault as read tools plus a constrained capture tool that only creates new notes in the inbox, enabling MCP clients to read and capture to a second brain.
    MIT

  • second-brain-mcp

    nanthansr
    A
    license
    A
    quality
    C
    maintenance
    Enables MCP clients to search and read notes from an Obsidian or markdown vault through four governed tools, with enforced read-only access, a page budget, and path sandboxing.
    4
    7 npm
    MIT