Advertise
MCP.so
Sign In
O

Obsidian MCP Server

@smith-and-web

Repository

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

smith-and-web

Submitted by

Josh Smith

About Obsidian MCP Server

No overview available yet

#obsidian#mcp#server

Obsidian MCP Server config

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

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "@smith-and-web/obsidian-mcp-server"
      ],
      "env": {
        "VAULT_PATH": "/path/to/your/vault",
        "PORT": "3001"
      }
    }
  }
}

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.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Obsidian MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Obsidian vault. It allows you to access notes, create content, manage tags, and search your knowledge base through natural conversation.

How to use Obsidian MCP Server?

Run the server via npx with the VAULT_PATH environment variable, or deploy with Docker. It exposes an SSE endpoint (port 3000 by default) that MCP clients like Claude Desktop or Cursor can connect to using mcp-remote. Configure the server in your AI assistant’s MCP settings pointing to the SSE URL.

Key features of Obsidian MCP Server

  • CRUD operations for notes with write modes (overwrite/append/prepend)
  • Frontmatter parsing and tag management with auditing
  • Full‑text search, backlinks, and broken‑link detection
  • Section‑level read, append, and replace operations
  • Optional compact response mode (40‑60% smaller payloads)
  • SSE transport for remote access without local installation

Use cases of Obsidian MCP Server

  • Ask an AI assistant to find notes by tag or full‑text search
  • Create, update, or delete notes and directories through conversation
  • Automate tag audits and bulk find‑and‑replace across the vault
  • Detect broken wiki‑links and list backlinks for a given note
  • Reorganize vault structure by moving or duplicating notes

Frequently asked questions

1

What dependencies does Obsidian MCP Server require?

It requires Node.js 18 or later and read/write access to an Obsidian vault (Markdown files). The server is built on Express.js and uses the gray‑matter library for YAML frontmatter.

2

Where does the server store data?

It reads and writes directly to the vault directory you mount at startup. No external database is used; all data lives in your existing `.md` files.

3

Is authentication supported?

Yes, the server supports optional API key authentication. When `API_KEY` is set, all `/sse` and `/message` endpoints require a Bearer token or `api_key` query parameter. The `/health` endpoint remains public.

4

What transport does the server use?

It uses Server‑Sent Events (SSE) for real‑time communication. Clients connect to `/sse` and can send messages via POST to `/message`. A direct MCP call endpoint is also available at `/sse` (POST).

5

Are there any known limits or performance considerations?

The server offers a compact response mode to reduce token usage. For large vaults, using `get-notes-info` instead of reading content improves efficiency. Full read/write access to the vault means caution is needed; delete operations require confirmation.

Comments

More Memory & Knowledge MCP servers

Leviathan Systems Public Content MCP

Leviathan Systems

Search published GPU deployment, rack integration and structured cabling resources; read canonical documents and Leviathan Systems company service scope. Anonymous, read-only Streamable HTTP MCP. No credentials required.

Sooveryn

PANDAPROG

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory, and finds them again by words and by meaning, from

UmmahAPI

Yousuf Kazmi

Islamic source data for assistants: Quran, hadith, tafsir, duas, prayer times and qibla. Answers come from real sources with citations instead of recalled text, so verses and hadith are not hallucinated. 36,000+ hadiths

Orcha

westonhancock

Orcha is a unified context layer for AI tools and agents. It stores and indexes and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and age

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio

Advertise