Obsidian-MCP: Instructions file for Codex

AGENTS.md - Obsidian MCP Guide for AI Assistants

This file explains the Obsidian MCP for AI coding agents and assistants

What is This MCP?

The Obsidian MCP is a Model Context Protocol server that connects AI assistants (like Amp) to Obsidian vaults, enabling AI-powered note creation, management, and organization.

Purpose: Allow AI agents to create, read, update, and organize notes in Obsidian vaults automatically during coding sessions.

Total Tools: 61 comprehensive note management tools

---

Quick Reference

When to Use This MCP

✅ Good use cases:

• User asks to "save this to Obsidian"
• User wants to document code or architecture
• User asks to "create a note about X"
• User wants to save code snippets for later
• User asks to organize or search their notes
• User wants to export documentation
• User requests vault statistics or analytics

❌ Don't use for:

• General file operations (use Read, create_file instead)
• Git operations (use Bash tool)
• Code execution or testing

Most Common Tools

Create Notes:

• save_code_snippet - Save code with syntax highlighting
• save_knowledge_note - Create general notes
• save_thread_summary - Archive AI conversations

Read & Search:

• list_notes - Browse vault
• read_note - Get note content
• search_notes - Find notes by content/tags

Export:

• export_vault_pdf - Beautiful PDF with table of contents
• export_note_pdf - Single note as PDF

---

Complete Tool Reference

📝 Note Creation (4 tools)

save_code_snippet

Save code with metadata, syntax highlighting, and tags.

{
  title: "Binary Search Algorithm",
  code: "function binarySearch(arr, target) {...}",
  language: "javascript",
  description: "Efficient search algorithm",
  tags: ["algorithms", "search", "javascript"]
}

When to use: User shares code they want to save for later reference.

save_thread_summary

Archive AI conversation with key insights and code snippets.