Enhanced Obsidian MCP Server - 25 Advanced AI Tools

English | 中文

🚀 Overview

The Enhanced Obsidian MCP Server is a powerful Model Context Protocol (MCP) server designed for seamless integration between AI models and Obsidian knowledge bases. Provides 25 powerful tools for intelligent knowledge management, automated content analysis, and smart linking capabilities.

✨ Core Features

• 🔗 Seamless Obsidian Integration: Direct access to Obsidian knowledge base through MCP protocol
• 📝 Complete Note Management: Read, create, update, and delete notes with advanced text replacement features
• 📁 Folder Operations: Create, rename, move, and delete folders with full hierarchy support
• 🔍 Intelligent Search: Full-text search across all file types with smart scoring
• 🤖 AI Analysis: Revolutionary strategic insights using TF-IDF framework
• 🔗 Auto Backlink Generation: Revolutionary intelligent detection of note names and conversion to wikilinks
• ⚡ Precise Editing: Advanced PATCH operations with heading and block-level positioning
• 🚀 Dual API Strategy: Obsidian REST API combined with file system fallback for maximum reliability
• 🎯 Context Optimization: Intelligent content summarization for LLM context length management
• 📊 Batch Processing: Efficient bulk operations with progress tracking

✨ New Features

• 🧠 15 New AI-Enhanced Tools for intelligent content analysis
• 🔗 Smart Auto-Linking with advanced pattern recognition
• 📊 Knowledge Graph Generation for visualizing note relationships
• 🏷️ Advanced Tag Management with intelligent suggestions
• 📝 Template System for consistent note creation
• 🔍 Content Similarity Analysis using TF-IDF and cosine similarity
• 📈 Relationship Analysis for discovering hidden connections

🛠️ Complete Tool Suite (25 Tools)

📚 Core Note Management (10 Tools)

📄 Note Operations

📁 Folder & Organization

🏷️ Tag Management System (3 Tools)

📝 Template System (4 Tools)

🧠 AI Content Analysis (4 Tools)

📊 Knowledge Graph & Analytics (4 Tools)

🚀 Quick Start

Option 1: NPM Installation (Recommended)

Install globally:

npm install -g @jianruidutong/obsidian-mcp

Or use npx (no installation required):

npx @jianruidutong/obsidian-mcp

Option 2: From Source

Clone and build:

git clone https://github.com/jianruidutong/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build
npm start

Option 3: Docker Installation

Quick start with Docker:

git clone https://github.com/jianruidutong/obsidian-mcp.git
cd obsidian-mcp
cp .env.example .env
# Edit .env with your vault settings
docker-compose up -d

📚 For detailed installation instructions, see Installation Guide

⚙️ Configuration

MCP Client Configuration

Option 1: NPM Installation Configuration

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": ["-y", "@jianruidutong/obsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "your_api_token",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

Option 2: Source Installation Configuration

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp/build/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "your_api_token",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

Option 3: Docker Installation Configuration

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "docker",
      "args": [
        "exec",
        "-i", 
        "obsidian-mcp-server",
        "npm",
        "start"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Note: For Docker, environment variables are configured in .env file or docker-compose.yml.

Environment Variables

🔧 For all configuration options, see Configuration Reference

📋 Prerequisites

1. Node.js (v16 or higher)
2. Obsidian Desktop Application
3. Local REST API Plugin installed in Obsidian

Setting Up Obsidian Local REST API

1. Install the "Local REST API" plugin in Obsidian
2. Generate an API token in the plugin settings
3. Note the port number (default: 27123)
4. Ensure the plugin is enabled

📚 Documentation

• 📖 Installation Guide - Complete installation instructions for all methods
• 🔧 Configuration Reference - Detailed configuration options and troubleshooting
• 🛠️ API Documentation - Complete API reference for all 25 tools
• 🚀 Usage Examples - Practical examples and real-world scenarios

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

git clone https://github.com/jianruidutong/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run dev

🐛 Troubleshooting

Common Issues

Connection refused error:

• Ensure Obsidian Local REST API plugin is installed and enabled
• Verify the API token and port number
• Check that Obsidian is running

Permission denied:

• Verify vault path permissions
• Ensure the API token has proper access rights

Environment variables not working:

• Use the OBSIDIAN_ prefix for all environment variables
• Restart your MCP client after configuration changes

🔍 For detailed troubleshooting, see Configuration Reference

📄 License

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

🙏 Acknowledgments

• Model Context Protocol by Anthropic
• Obsidian Local REST API plugin
• The original project address: https://github.com/newtype-01/obsidian-mcp

📞 Support

• 🐛 Report Issues
• 💬 Discussions

⭐ Star this repository if you find it useful! ⭐