Obsidian

Manage Obsidian vaults with knowledge graph operations and AI-powered features.

View on GitHub →

Enhanced MCP Obsidian Server

A comprehensive Model Context Protocol (MCP) server for Obsidian vault management with advanced knowledge graph operations and AI-powered features.

Features

Core Operations

  • CRUD Operations: Full create, read, update, delete support for notes
  • Frontmatter Support: Complete YAML frontmatter processing
  • Template System: Note creation with templates
  • Real-time Monitoring: Automatic vault updates via file watching

Knowledge Graph

  • Link Analysis: Bidirectional link tracking (backlinks & forward links)
  • Network Analysis: Comprehensive vault network insights
  • Orphaned Notes: Detect isolated notes
  • Broken Links: Identify and report broken references
  • Central Nodes: Find most connected notes

Advanced Search

  • Full-text Search: Content-based search with fuzzy matching
  • Tag Filtering: Search by specific tags
  • Date Range Filtering: Time-based note filtering
  • Result Limiting: Configurable result counts

Intelligence Features (Optional)

  • Content Summarization: AI-powered note summaries
  • Concept Extraction: Key topic identification
  • Connection Suggestions: Smart link recommendations
  • Vault Analytics: Comprehensive statistics

Installation

Via NPX (Recommended)

npx @lepion/mcp-server-obsidian-enhanced /path/to/vault

Via MCP Configuration

Add to your MCP settings:

{
  "mcpServers": {
    "obsidian-enhanced": {
      "command": "npx",
      "args": ["-y", "@lepion/mcp-server-obsidian-enhanced", "/path/to/vault"],
      "env": {
        "OBSIDIAN_ENABLE_AI_FEATURES": "false"
      }
    }
  }
}

Configuration

Environment Variables

  • OBSIDIAN_ENABLE_AI_FEATURES: Enable AI-powered features (default: false)
  • LOG_LEVEL: Logging level (default: info)

Tools

Core Tools

  • obsidian_create_note: Create new notes with frontmatter
  • obsidian_read_note: Read note with full metadata
  • obsidian_update_note: Update existing notes (replace/append/prepend)
  • obsidian_delete_note: Delete notes (with confirmation)
  • obsidian_full_text_search: Advanced search with filtering

Knowledge Graph Tools

  • obsidian_get_backlinks: Get incoming links to a note
  • obsidian_get_forward_links: Get outgoing links from a note
  • obsidian_analyze_link_network: Comprehensive network analysis
  • obsidian_find_orphaned_notes: Find isolated notes
  • obsidian_vault_statistics: Get vault analytics

Legacy Compatibility

  • search_notes: Compatible with smithery-ai/mcp-obsidian
  • read_notes: Bulk note reading

AI-Powered Tools (when enabled)

  • obsidian_summarize_note: Generate note summaries
  • obsidian_extract_key_concepts: Extract key topics
  • obsidian_suggest_connections: Smart connection suggestions

Security

  • Path validation ensures access only within specified vault
  • Hidden file/directory protection
  • No access to system files outside vault boundaries

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev /path/to/vault

# Run tests
npm test

# Run with coverage
npm run test:coverage

License

MIT License - see LICENSE file for details.

Related Servers