Skip to main content
Glama
Mochiduki-0715

obsidian-mcp

by Mochiduki-0715
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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

OBSIDIAN_TEMPLATE_DIR

Folder for templates, relative to the vault root

Templates

Related MCP server: Obsidian MCP Server

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)

update_frontmatter

Update YAML frontmatter by key: merge set values, delete remove keys, body untouched

search_notes

Case-insensitive full-text search, with optional tag, frontmatter, and regex filters

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); warns if the note is still linked from elsewhere

backlinks

List notes that link to a given note, with file/line/link-type

daily_note

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

get_outline

Get a note's heading outline (level/text/line) and line count, skipping code fences

create_from_template

Create a note from a template in OBSIDIAN_TEMPLATE_DIR, substituting {{date}}, {{title}}, and custom {{variables}}

Testing

npm test

Runs the TypeScript build followed by Node's built-in test runner (node --test) against the compiled dist/*.test.js files.

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

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
1dResponse time
–Release cycle
–Releases (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.

Tools

Related MCP Servers

  • Obsidian MCP Server

    suhailnajeeb
    A
    license
    -
    quality
    D
    maintenance
    Enables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.
    MIT

  • Obsidian MCP Local

    HenriqueCSouzza
    A
    license
    C
    quality
    D
    maintenance
    Enables AI assistants to search, read, create, and modify Markdown notes in local Obsidian vaults directly through filesystem operations. Supports tag-based discovery and frontmatter parsing without requiring Obsidian to be open, facilitating integration with VS Code Copilot via stdio transport.
    5
    9
    4
    MIT

  • mcp-obsidian-vault

    t-rhex
    A
    license
    -
    quality
    C
    maintenance
    Provides AI agents with direct filesystem access to an Obsidian vault for note management, task orchestration, context persistence, and git synchronization.
    67
    1
    MIT

View all related MCP servers

Related MCP Connectors

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

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