MCP Reference Overview

While the core logic of obx supports 72 distinct actions, exposing all of those to modern LLMs (like Claude or GPT-4o) frequently causes the intelligent agent to breach its hard tool limits when run alongside other MCP servers.

To maximize stability and ensure your assistant can handle complex multi-server workflows, obx multiplexes these 72 actions into 16 unified MCP Tools.

When your AI assistant needs to do something, it calls one of these 16 parent tools and passes an action argument (e.g. action: "read" vs action: "write").

Unified Tool Groups

manage-notes Read, write, append, rename, duplicate, and move markdown notes.

manage-folders List, create, or delete directory structures.

search-vault Compact or detailed searches via queries, regex, tags, or fields.

manage-frontmatter Read, set, or append properties, tags, and aliases.

bulk-operations Batch tag, move, or modify properties across numerous files at once.

manage-links Retrieve backlinks, forward links, or ask the AI to suggest connections.

analyze-vault Find stubs, orphans, broken links, and outdated notes.

manage-tasks Locate Markdown checkboxes and toggle their completion states.

manage-periodic-notes Fetch or create daily, weekly, monthly, quarterly, or yearly notes.

manage-mocs Discover existing Maps of Content or automatically generate new index files.

manage-templates List core templates and apply them dynamically.

manage-canvas Create notes and edges within Obsidian Canvas interface.

edit-note Surgically alter notes via search/replace sequences or string batches.

read-batch Ingest multiple notes at once, or extract specific headings for summaries.

refactor-notes Split notes by heading, merge multiple notes, and extract sections to new notes.

manage-vaults Dynamically rotate the active vault handled by the server without restarting.