ClaudeVault

ClaudeVault

A powerful TypeScript-based Model Context Protocol (MCP) server that enables intelligent note-taking with Obsidian Vault integration and Git synchronization. Built for seamless integration with Claude Desktop and cross-device knowledge management workflows.

🌟 Features

📝 Complete Note Management

• Create, Read, Update, Delete notes with rich metadata
• Smart search across titles, content, tags, projects, and categories
• Flexible organization with tags, projects, and categories
• Preview and confirmation system for safe updates and deletions
• Unique ID generation with timestamp-based identification

🗂️ Obsidian Vault Integration

• Markdown file storage in your Obsidian vault
• Smart note linking with automatic relationship detection
• Cross-note connections for enhanced knowledge graphs
• Subfolder organization for clean vault structure
• Direct Obsidian compatibility for seamless editing

🔄 Unified Git Synchronization (v2.0)

• Single repository workflow with direct vault integration
• Enhanced smart linking between related notes
• Faster cross-device sync with optimized Git operations
• Multiple sync strategies: full, status, pull, push, save-and-push
• Conflict-free operations with proper Git workflow
• Batch operations for efficient bulk syncing
• Emergency sync for conflict resolution

⚙️ Professional Configuration

• Environment variable support for flexible deployment
• Configurable vault paths and Git settings
• Clean modular architecture with separated concerns
• TypeScript implementation with full type safety
• Production-ready error handling and logging

🚀 Quick Start

Prerequisites

• Node.js 18+
• Git configured with remote repository access
• Obsidian vault (local directory)
• Claude Desktop application

Installation

1. Clone the repository

   git clone https://github.com/Cannon07/ClaudeVault.git
   c