Yamos

What it does

Yamos is a Model Context Protocol (MCP) server that allows AI agents to interact with your Obsidian vault remotely. It bridges the gap between AI clients and your personal knowledge base by connecting to a CouchDB instance where Obsidian-Livesync stores vault data. This enables a seamless, remote sync between your notes and your AI, regardless of whether the AI client is running locally or in the cloud.

Tools

• list_notes: Lists all notes in the vault, with optional path filtering.
• read_note: Retrieves the full content of a specific note.
• write_note: Creates a new note or updates an existing one.
• append_to_note: Adds content to the end of an existing note.
• insert_lines: Inserts content at a specific line number in a note.
• delete_lines: Removes a range of lines from a note.
• delete_note: Permanently removes a note from the vault.
• batch_read_notes: Reads multiple notes in a single request for efficiency.
• batch_write_notes: Creates or updates multiple notes simultaneously.
• batch_delete_notes: Deletes multiple notes in one operation.
• batch_append_to_notes: Appends content to multiple notes at once.

Installation

To use Yamos, you must first have a CouchDB instance configured with the Obsidian-Livesync plugin.

For Claude Desktop (stdio mode):

{
  "mcpServers": {
    "yamos": {
      "command": "cargo",
      "args": ["run", "--manifest-path", "/path/to/yamos/Cargo.toml", "--"]
    }
  }
}

Supported hosts

• claude