Skip to main content
Glama
NeveuGregor

mcp-obsidian

by NeveuGregor

mcp-obsidian

🇬🇧 English · 🇫🇷 Français

A filesystem-based MCP server for an Obsidian vault. It reads and writes your vault's Markdown files directly on disk — no Obsidian plugin, no Local REST API, no running Obsidian instance required. Point it at a folder and your LLM can browse and edit notes.

Why filesystem-based

Most Obsidian MCP servers talk to the Local REST API community plugin, which means Obsidian must be running with the plugin enabled. mcp-obsidian skips all that and operates on the vault directory itself — works headless, in CI, or on a synced folder.

Related MCP server: Obsidian MCP Tool Server

Tools

Tool

Description

obsidian_read

Read a note (with optional truncation)

obsidian_search

Keyword search across notes, with truncated context per hit; optional subfolder scope

obsidian_write

Create or overwrite a note (creates parent folders)

obsidian_append

Append content to a note

obsidian_patch_frontmatter

Patch a note's YAML frontmatter

obsidian_list

List .md files and subfolders of a directory

All paths are relative to the vault root (e.g. wiki/cyber/sql-injection.md).

Scope

This server is transport only. It has no notion of a "claim", no conflict detection and no merge policy — obsidian_write is a plain overwrite, last write wins. Contradiction handling, note conventions and the human-in-the-loop review step live one layer up, in claude-obsidian-system.

Install

git clone https://github.com/NeveuGregor/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build      # compiles TypeScript to dist/

Configuration

The vault path is provided via the OBSIDIAN_VAULT environment variable (absolute path). The server exits with an error if it is not set.

Register it with Claude (CLI or Desktop), e.g. in your MCP config:

{
  "mcpServers": {
    "obsidian": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-obsidian/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT": "/absolute/path/to/your/vault"
      }
    }
  }
}

Requirements

  • Node.js 18+

  • An Obsidian vault (just a folder of Markdown files)

This server is the MCP layer of a broader knowledge architecture — claude-obsidian-system — which documents how the vault itself is designed (LLM-Wiki + Zettelkasten + Evergreen) and wired to Claude Code skills and memory.

License

CeCILL-B (BSD-compatible, French law) — © 2026 Neveu Grégor.

Install Server
F
license - not found
A
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    Provides an MCP server that allows AI assistants to interact with Obsidian vaults, enabling reading/writing notes, managing metadata, searching content, and working with daily notes.
    Last updated
    36
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    A local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.
    Last updated
    2
  • A
    license
    -
    quality
    C
    maintenance
    MCP server that provides read and write access to an Obsidian vault by interacting directly with markdown files on disk. Supports searching, listing, reading, creating, editing, and appending notes without requiring any Obsidian plugins.
    Last updated
    3,424
    ISC

View all related MCP servers

Related MCP Connectors

  • Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.

  • Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NeveuGregor/mcp-obsidian'

If you have feedback or need assistance with the MCP directory API, please join our Discord server