Skip to main content
Glama
Mochiduki-0715

obsidian-mcp

obsidian-mcp

An MCP (Model Context Protocol) server that lets AI coding agents (Claude Code, Codex CLI, etc.) read, write, search, and organize notes in an Obsidian vault. It works directly on the filesystem, so Obsidian doesn't need to be running — Obsidian picks up external changes automatically.

Community project — not affiliated with Obsidian.

Setup

git clone https://github.com/Mochiduki-0715/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build

Configuration is done through environment variables:

Variable

Description

Default

OBSIDIAN_VAULT_PATH

Absolute path to your vault folder

(required)

OBSIDIAN_DAILY_DIR

Folder for daily notes, relative to the vault root

Daily

Registering with agents

Claude Code

claude mcp add --scope user obsidian \
  --env OBSIDIAN_VAULT_PATH=$HOME/path/to/your/vault \
  -- node /path/to/obsidian-mcp/dist/index.js

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.obsidian]
command = "node"
args = ["/path/to/obsidian-mcp/dist/index.js"]

[mcp_servers.obsidian.env]
OBSIDIAN_VAULT_PATH = "/path/to/your/vault"

Tools

Tool

Description

list_notes

List notes, newest first; optionally restricted to a subfolder

read_note

Read a note, returning parsed frontmatter and the markdown body

create_note

Create a note (pass overwrite: true to replace an existing one)

append_note

Append text; with heading, insert at the end of that section

edit_note

Edit by exact string replacement (old_text / new_text)

search_notes

Case-insensitive full-text search, with an optional tag filter

move_note

Move/rename a note and rewrite [[wikilinks]] across the vault

delete_note

Move a note to the vault's .trash/ folder (safe delete)

daily_note

Get or create the daily note for today or a given date

Safety

  • Every path is resolved inside the vault root; .. escapes are rejected

  • Deleting moves notes to Obsidian's standard .trash/ folder instead of removing them

  • create_note never silently overwrites an existing note (an explicit flag is required)

License

MIT

-
license - not tested
-
quality - not tested
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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/Mochiduki-0715/obsidian-mcp'

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