Skip to main content
Glama
jkang8

mcp-obsidian

by jkang8
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OBSIDIAN_VAULT_PATHYesThe absolute path to your Obsidian vault directory

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_filesA

List files and folders inside the vault (or a subdirectory of it).

Args:
    path: Relative path within the vault to list. Defaults to the vault root.
read_noteB

Read the contents of a note in the vault.

Args:
    path: Relative path to the note file (e.g. 'folder/My Note.md').
write_noteA

Create or overwrite a note in the vault.

Args:
    path: Relative path to the note (e.g. 'folder/New Note.md').
          Parent directories are created automatically.
    content: Markdown content to write.
search_notesA

Full-text search across all markdown notes in the vault.

Args:
    query: Search string (case-insensitive).
delete_noteB

Delete a note or folder from the vault.

Args:
    path: Relative path to the note or folder to delete.
move_noteB

Move or rename a note within the vault.

Args:
    src: Relative path to the source note or folder.
    dest: Relative path to the destination (new name/location).
append_to_noteC

Append content to the end of an existing note.

Args:
    path: Relative path to the note.
    content: Markdown content to append.
get_frontmatterA

Parse and return the YAML frontmatter of a note as key-value pairs.

Args:
    path: Relative path to the note.
update_frontmatterB

Set or update a frontmatter field in a note. Creates frontmatter if absent.

Args:
    path: Relative path to the note.
    key: Frontmatter key to set (e.g. 'status', 'tags').
    value: Value to set. Use comma-separated values for lists (e.g. 'tag1,tag2').
get_backlinksA

Find all notes that link to the given note via [[wikilinks]].

Args:
    path: Relative path to the note (e.g. 'Notes/My Note.md').
get_outlinksA

Extract all [[wikilinks]] from a note.

Args:
    path: Relative path to the note.
get_orphansA

Find notes with no incoming backlinks and no outgoing wikilinks.

get_daily_noteB

Read the daily note for a given date (defaults to today).

Args:
    date_str: Date in YYYY-MM-DD format. Defaults to today.
create_daily_noteB

Create a daily note for a given date, using a daily template if available.

Args:
    date_str: Date in YYYY-MM-DD format. Defaults to today.
list_tagsA

List all tags used across the vault with their usage counts.

search_by_tagB

Find all notes containing a specific tag.

Args:
    tag: Tag to search for (with or without leading #).
get_recent_notesA

List the N most recently modified notes in the vault.

Args:
    n: Number of notes to return (default 10).
get_note_statsB

Return statistics about the vault: note count, word count, tag count, link count.

list_templatesA

List all available templates in the vault's Templates folder.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
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

TDQS

A3.7/5.0

Scored across 19 tools

Disambiguation4/5

Most tools have distinct purposes targeting specific operations like reading, writing, searching, or managing metadata, with clear boundaries. However, some overlap exists between 'read_note' and 'get_daily_note' (which also reads a note), and 'write_note' and 'create_daily_note' (both create notes), though their specialized contexts help differentiate them.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern using snake_case, such as 'append_to_note', 'delete_note', and 'search_notes'. This uniformity makes the set predictable and easy to navigate, with no deviations in style or convention.

Tool Count4/5

With 19 tools, the count is slightly high but reasonable for a comprehensive note-taking system like Obsidian, covering operations from basic CRUD to advanced features like backlinks and templates. It might feel heavy but aligns well with the domain's complexity.

Completeness5/5

The toolset provides complete coverage for managing an Obsidian vault, including full CRUD for notes (create, read, update, delete), metadata handling (frontmatter), search capabilities (full-text, tags), and vault analytics (stats, orphans). No obvious gaps exist for core workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources