Obsidian MCP Server

Connect your Obsidian vault to Amp and supercharge your note-taking with AI

Use Amp (Sourcegraph's AI coding assistant) to automatically create, update, and manage notes in your Obsidian vault. Perfect for documentation, learning logs, code snippets, and building a knowledge base as you code.

🚀 Now with 121 comprehensive tools for complete Obsidian automation!

✨ Features

🎯 What's New in v4.0

• 🎨 Canvas Integration - Create and manipulate Obsidian Canvas boards programmatically
• 📊 Dataview Queries - Execute database-like queries on your vault
• 🌐 Graph Analysis - Analyze knowledge networks, find clusters, calculate centrality
• 🔗 Advanced URI Generation - Create deep links to Obsidian (obsidian:// URIs)
• 📎 Enhanced Attachments - Better media file management
• 🔍 Advanced Search & Replace - Regex search, frontmatter search, vault-wide refactoring
• 🏷️ Enhanced Metadata - Advanced frontmatter manipulation and batch updates
• 📚 Structured Templates - Pre-formatted note types (books, people, meetings, projects)
• ✅ Enhanced Task Management - Filter by criteria, add metadata, generate reports
• 📐 Advanced Formatting - Callouts, tables, TOC, Mermaid diagrams, LaTeX math
• 🔧 Vault Maintenance - Health analysis, find duplicates, cleanup automation
• 🔄 Cross-Note Analysis - Compare, merge, split notes intelligently

Core Capabilities

• 🤖 AI-Powered Note Creation - Let Amp create structured notes for you
• 📝 Code Snippet Library - Automatically save code with syntax highlighting
• 🧠 Knowledge Graphs - Build interconnected notes with automatic linking
• 📊 Thread Summaries - Save your Amp conversations for future reference
• 🔍 Vault Search - Search notes by content, tags, metadata, regex
• 🏷️ Smart Tagging - Automatic categorization and organization
• 🔗 Cross-Referencing - Link related notes automatically
• 📈 Analytics - Vault statistics, health reports, insights
• 💾 Export Everything - PDF, HTML, JSON, CSV, Markdown bundles

🚀 Quick Start

Prerequisites

• Node.js v18 or higher
• Amp installed
• Obsidian installed (recommended)

Installation

1. Clone the repository:

   git clone https://github.com/Kynlos/Obsidian-MCP.git
   cd Obsidian-MCP
   

2. Install dependencies:

   npm install
   

3. Run the setup wizard:

   npm run setup
   

   The setup wizard will:

   • Prompt you for your Obsidian vault path
   • Create a .env configuration file
   • Configure Amp automatically for your platform (Windows/macOS/Linux)

4. Restart Amp

5. Test it:

   npm test
   

   Or in Amp:

   You: "Create a note in Obsidian called 'Test' with content 'Hello from Amp!'"
   

⚙️ Configuration

Workspace-Relative Vaults (New!)

By default, vaults are created in your current workspace directory - no hardcoded paths needed!

# Optional: Override defaults
VAULTS_BASE_PATH=/path/to/your/vaults/folder
OBSIDIAN_VAULT_PATH=/path/to/your/default/vault

Automatic Setup (Recommended)

Run the setup wizard to configure everything automatically:

npm run setup

Manual Setup

1. Copy .env.example to .env:

   cp .env.example .env
   

2. Configure Amp by editing the config file:

   • Windows: %APPDATA%\Amp\mcp-config.json
   • macOS/Linux: ~/.config/amp/mcp-config.json

   Add this configuration:

   {
     "mcpServers": {
       "obsidian": {
         "command": "node",
         "args": ["/absolute/path/to/Obsidian-MCP/index.js"]
       }
     }
   }
   

3. Restart Amp

🛠️ Available Tools

The Obsidian MCP provides 121 powerful tools organized into 14 categories:

🎨 Canvas Integration (6 tools)

Create and manipulate Obsidian Canvas files (JSON-based visual boards).

📊 Dataview Query Execution (3 tools)

Execute database-like queries on your vault (simplified implementation).

🌐 Graph Analysis (5 tools)

Analyze your knowledge network programmatically.

🔗 Advanced URI Generation (4 tools)

Create obsidian:// deep links for automation and external integrations.

📎 Attachments & Media Management (5 tools)

Manage media files and attachments in your vault.

🔍 Advanced Search & Replace (4 tools)

Powerful search and refactoring tools.

🏷️ Enhanced Metadata/Frontmatter (6 tools)

Advanced YAML frontmatter manipulation.

📚 Structured Content Templates (5 tools)

Create common note types with pre-formatted structures.

✅ Enhanced Task Management (5 tools)

Advanced task data management beyond basic TODO lists.

📐 Advanced Markdown Formatting (6 tools)

Automate tedious formatting tasks.

🔧 Vault Maintenance (5 tools)

Keep your vault healthy and organized.

🔄 Cross-Note Analysis (5 tools)

Compare, refactor, and reorganize notes.

📝 Core Note Creation (4 tools)

✏️ Core Note Management (5 tools)

See complete tool documentation in AGENTS.md

💡 Usage Examples

Create a Canvas Board

You: "Create a canvas called 'Project Planning' and add cards for Frontend, Backend, and Database"

Execute Dataview Query

You: "Show me all notes tagged with 'python' created this month"

Generate Obsidian URIs

You: "Create a link I can use to open my Daily Note from outside Obsidian"

Analyze Vault Structure

You: "Show me the most connected notes in my vault and find any isolated notes"

Create Structured Notes

You: "Create a book note for 'The Pragmatic Programmer' by Andy Hunt and Dave Thomas"

Advanced Formatting

You: "Create a Mermaid flowchart showing the authentication process and add it to my Security note"

See 50+ more examples →

🔧 Available Commands

🧪 Testing

Verify your setup is working correctly:

npm test

This will check:

• .env file exists and is valid
• Obsidian vault path is accessible
• Amp configuration is correct
• All dependencies are installed
• Node.js version is compatible

📊 Version History

• v4.0.0 (2025-11-13) - MAJOR UPDATE: Added 59 new tools (Canvas, Dataview, Graph Analysis, URIs, and much more!)
• v3.1.0 - Export features (PDF, HTML, JSON, CSV)
• v3.0.0 - Template system and advanced search
• v2.0.0 - Task management and analytics
• v1.0.0 - Initial release

See full changelog →

🎯 Platform Support

This MCP works on:

• ✅ Windows (10, 11)
• ✅ macOS (10.15+)
• ✅ Linux (Ubuntu, Debian, Fedora, etc.)

Automatic configuration paths:

• Windows: %APPDATA%\Amp\mcp-config.json
• macOS/Linux: ~/.config/amp/mcp-config.json

📚 Documentation

• AGENTS.md - Complete tool reference for AI agents
• SETUP.md - Detailed setup instructions
• EXAMPLES.md - Real-world usage examples
• CONTRIBUTING.md - How to contribute
• CHANGELOG.md - Version history

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• Repository: https://github.com/Kynlos/Obsidian-MCP
• Amp: https://ampcode.com/
• Obsidian: https://obsidian.md/
• MCP Specification: https://modelcontextprotocol.io/

🙏 Acknowledgments

• Kynlo for creating the original Obsidian MCP Server
• Sourcegraph for Amp
• Obsidian team for the amazing note-taking app

Made with ❤️ for the Amp and Obsidian communities

⭐ Star this repo if you find it useful!