Which integrations are available for this server?

Provides comprehensive tools for managing Obsidian vaults, including note creation and editing, canvas manipulation, dataview queries, graph analysis, task management, metadata operations, attachment handling, and vault maintenance. Supports 121+ tools for automating note-taking, building knowledge bases, and organizing information.

How do I use Obsidian MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Obsidian MCP Server create a meeting note for today's design review with the team" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Clone the repository:
git clone https://github.com/Kynlos/Obsidian-MCP.git cd Obsidian-MCP
Install dependencies:
npm install
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)
Restart Amp
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

Copy .env.example to .env:
cp .env.example .env
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"] } } }
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).

Tool	Description
`create_canvas`	Create new canvas JSON files
`add_card_to_canvas`	Add text/note/media cards to canvas
`add_connection_to_canvas`	Connect cards with lines/arrows
`create_canvas_group`	Group cards together
`read_canvas`	Parse and read canvas structure
`update_canvas_card`	Modify existing canvas cards

📊 Dataview Query Execution (3 tools)

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

Tool	Description
`execute_dataview_query`	Run Dataview DQL queries and return results
`create_dataview_codeblock`	Insert dataview query blocks into notes
`validate_dataview_query`	Check if query syntax is valid

🌐 Graph Analysis (5 tools)

Analyze your knowledge network programmatically.

Tool	Description
`generate_graph_data`	Build graph structure from vault links (nodes/edges)
`find_note_clusters`	Identify groups of related notes
`calculate_note_centrality`	Find most connected/important notes
`get_shortest_path`	Find link path between two notes
`find_isolated_notes`	Notes with few/no connections

🔗 Advanced URI Generation (4 tools)

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

Tool	Description
`generate_obsidian_uri`	Create obsidian:// URIs for deep linking
`create_workspace_uri`	Generate URI to open workspace
`create_append_uri`	Generate URI to append text to note
`create_search_uri`	Generate URI to search vault

📎 Attachments & Media Management (5 tools)

Manage media files and attachments in your vault.

Tool	Description
`list_attachments`	List all media files in vault
`attach_file`	Copy external file into vault attachments folder
`delete_attachment`	Remove attachment files
`find_orphaned_attachments`	Find unused media files
`get_attachment_references`	Find which notes use an attachment

🔍 Advanced Search & Replace (4 tools)

Powerful search and refactoring tools.

Tool	Description
`regex_search_and_replace`	Find and replace with regex across vault
`search_in_frontmatter`	Search YAML frontmatter specifically
`search_by_link_type`	Find specific link patterns (wiki vs markdown)
`multi_file_replace`	Batch find/replace across multiple notes

🏷️ Enhanced Metadata/Frontmatter (6 tools)

Advanced YAML frontmatter manipulation.

Tool	Description
`update_frontmatter_field`	Edit specific YAML field without rewriting note
`batch_update_metadata`	Update property across multiple notes
`validate_frontmatter_schema`	Check frontmatter against schema
`list_all_properties`	Get all unique property keys in vault
`rename_property_globally`	Rename property across all notes
`get_property_values`	List all values for a property

📚 Structured Content Templates (5 tools)

Create common note types with pre-formatted structures.

Tool	Description
`create_from_template_with_prompts`	Template with variable substitution
`create_book_note`	Structured book/literature note
`create_person_note`	Person/contact note structure
`create_meeting_note`	Meeting notes with agenda/action items
`create_project_note`	Project planning note structure

✅ Enhanced Task Management (5 tools)

Advanced task data management beyond basic TODO lists.

Tool	Description
`get_tasks_by_criteria`	Filter tasks by status, date, priority, tags
`move_task_between_notes`	Relocate task to different note
`add_task_metadata`	Add due date, priority, tags to task
`create_task_report`	Generate task summary/report
`find_blocked_tasks`	Tasks waiting on dependencies

📐 Advanced Markdown Formatting (6 tools)

Automate tedious formatting tasks.

Tool	Description
`convert_to_callout`	Wrap text in callout blocks
`create_markdown_table`	Generate tables programmatically
`add_table_of_contents`	Generate TOC from headings
`create_mermaid_diagram`	Generate Mermaid diagrams from data
`create_math_block`	Add LaTeX math blocks
`standardize_formatting`	Fix inconsistent markdown formatting

🔧 Vault Maintenance (5 tools)

Keep your vault healthy and organized.

Tool	Description
`find_duplicate_notes`	Detect similar/duplicate content
`find_empty_notes`	List notes with no content
`find_large_notes`	Notes exceeding size threshold
`analyze_vault_health`	Overall vault statistics/issues
`cleanup_broken_references`	Remove/fix broken links

🔄 Cross-Note Analysis (5 tools)

Compare, refactor, and reorganize notes.

Tool	Description
`compare_notes`	Diff two notes
`find_similar_notes`	Content similarity analysis
`track_note_changes`	Compare note versions over time
`merge_notes_enhanced`	Smart merge with options
`split_note_by_headings`	Break large note into smaller ones

📝 Core Note Creation (4 tools)

Tool	Description
`save_code_snippet`	Save code with syntax highlighting and metadata
`save_thread_summary`	Save AI conversation summaries with key insights
`save_knowledge_note`	Create general knowledge notes with tags
`create_daily_note`	Create daily notes with optional custom templates

✏️ Core Note Management (5 tools)

Tool	Description
`read_note`	Read the full content of a note
`update_note`	Update note content (preserves metadata by default)
`delete_note`	Delete a note from the vault
`append_to_note`	Append content to the end of an existing note
`rename_note`	Rename a note file

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

Command	Description
`npm install`	Install dependencies
`npm run setup`	Run interactive setup wizard
`npm test`	Test configuration
`npm start`	Start the MCP server (for debugging)

🧪 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!

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers