Skip to main content
Glama
deenesjakoruzh
Airgap-fleet

Obsidian MCP Server

by Airgap-fleet
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Obsidian MCP Server

FastMCP server for Obsidian vault operations — read, write, search, and manage notes via Model Context Protocol.

Features

  • read_note — Read a note with optional frontmatter parsing

  • write_note — Write notes with YAML frontmatter support

  • list_notes — List notes with glob filtering and recursion

  • search_notes — Regex search across vault content

  • search_frontmatter — Query notes by frontmatter key/value

  • get_daily_note — Get or create daily notes with templates

Related MCP server: Obsidian RAG MCP Server

Installation

pip install -e .

Usage

obsidian-mcp

Or configure in your MCP client:

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "env": {
        "OBSIDIAN_MCP_VAULT_PATH": "C:/path/to/vault"
      }
    }
  }
}

Configuration

Environment Variable

Default

Description

OBSIDIAN_MCP_VAULT_PATH

Current directory

Path to Obsidian vault root

OBSIDIAN_MCP_MAX_FILE_SIZE

10MB

Max file size for operations

OBSIDIAN_MCP_DEFAULT_ENCODING

utf-8

Text encoding

OBSIDIAN_MCP_INDEX_FRONTMATTER

true

Parse YAML frontmatter

OBSIDIAN_MCP_FOLLOW_SYMLINKS

false

Follow symlinks

Tool Reference

read_note

{
  "path": "Projects/roadmap.md",
  "include_frontmatter": true
}

write_note

{
  "path": "Projects/new-idea.md",
  "content": "# New Idea\n\nDetails here...",
  "frontmatter": { "tags": ["idea", "draft"], "status": "wip" }
}

list_notes

{
  "path": "Projects",
  "glob_pattern": "**/*.md",
  "recursive": true
}

search_notes

{
  "pattern": "MCP",
  "path": ".",
  "max_results": 50
}

search_frontmatter

{
  "key": "status",
  "value": "done",
  "operator": "eq"
}

get_daily_note

{
  "date": "2026-08-21",
  "folder": "Daily Notes",
  "create_if_missing": true
}

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
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Obsidian MCP Server

    cyanheads
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables interaction between LLMs and Obsidian vaults through the Model Context Protocol, supporting secure file operations, content management, and advanced search capabilities.
    6,222 npm
    676
    Apache 2.0

  • Obsidian RAG MCP Server

    claudiogarza
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables semantic search and content retrieval from local Obsidian vaults through the Model Context Protocol. It allows AI assistants to query notes by meaning, filter by tags, and access full note content for enhanced knowledge integration.
    MIT

  • Obsidian MCP Server

    frstlvl
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Obsidian vaults through vector search, vault indexing, and file monitoring. It provides a standardized interface for searching and managing markdown-based personal knowledge management data within the Model Context Protocol.
    6,222 npm
    1
    MIT

  • obsidian-mcp-server

    indie-geeker
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI to manage Obsidian notes, including creation, reading, updating, deletion, full-text search, listing with filtering, sorting, and metadata extraction via the Model Context Protocol.
    9 npm
    MIT