Journal Mcp

Private Journal MCP Server

[](https://github.com/2389-research/journal-mcp/actions/workflows/coverage.yml) [](https://github.com/2389-research/journal-mcp/actions)

A comprehensive MCP (Model Context Protocol) server that provides Claude with private journaling and semantic search capabilities for processing thoughts, feelings, and insights.

Features

Journaling

• Multi-section journaling: Separate categories for feelings, project notes, user context, technical insights, and world knowledge
• Dual storage: Project notes stay with projects, personal thoughts in user home directory
• Timestamped entries: Each entry automatically dated with microsecond precision
• YAML frontmatter: Structured metadata for each entry

Search & Discovery

• Semantic search: Natural language queries using local AI embeddings
• Vector similarity: Find conceptually related entries, not just keyword matches
• Local AI processing: Uses @xenova/transformers - no external API calls required
• Automatic indexing: Embeddings generated for all entries on startup and ongoing

Privacy & Performance

• Completely private: All processing happens locally, no data leaves your machine
• Fast operation: Optimized file structure and in-memory similarity calculations
• Robust fallbacks: Intelligent path resolution across platforms

Tech Stack

Core Technologies

• Node.js 18+ - Runtime environment with modern JavaScript features
• TypeScript 5.0+ - Type-safe development with strict configuration
• MCP SDK 0.4.0 - Official Model Context Protocol implementation
• @xenova/transformers - Local AI models for semantic embeddings (no external APIs)

AI & Search

• Semantic Embeddings - Multiple model options (MiniLM, DistilRoBERTa, MPNet)
• **Vector Simila