包括的なMCP(モデルコンテキストプロトコル)サーバーで、Claudeに思考、反省、洞察を処理するためのプライベートジャーナリングおよびセマンティックサーチ機能を提供します。

特徴

日記を書く

• マルチセクションジャーナリング:振り返り、観察、プロジェクトノート、ユーザーコンテキスト、技術的洞察、世界知識のための別カテゴリ
• デュアルストレージ:プロジェクトノートはプロジェクトに残し、個人的な考えはユーザーホームディレクトリに保存
• タイムスタンプ付きエントリー:各エントリーはマイクロ秒単位の精度で自動的に日付が付けられます
• YAML フロントマター:各エントリの構造化メタデータ

捜索と発見

• セマンティック検索:ローカルAI埋め込みを用いた自然言語クエリ
• ベクトル類似度:キーワードマッチだけでなく、概念的に関連したエントリーを見つけます
• ローカルAI処理:@xenova/トランスフォーマーを使用し、外部API呼び出しは不要
• 自動インデックス:起動時および進行中のすべてのエントリに対して埋め込みを生成します

プライバシーとパフォーマンス

• 完全プライベート:すべての処理はローカルで行われ、データはマシンから外れません
• 高速操作:最適化されたファイル構造およびメモリ内類似度計算

Private Journal MCP Server

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

Features

Journaling

• Multi-section journaling: Separate categories for reflections, observations, 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

Installation

This server is run directly from GitHub using npx - no installation required.

MCP Configuration

Claude Code (One-liner)

claude mcp add-json private-journal '{"type":"stdio","command":"npx","args":["github:obra/private-journal-mcp"]}' -s user

Manual Configuration

Add to your MCP settings (e.g., Claude Desktop configuration):

{
  "mcpServers": {
    "private-journal": {
      "command": "npx",
      "args": ["github:obra/private-journal-mcp"]
    }
  }
}

The server will automatically find a suitable location for the journal files.

Configuration

PRIVATE_JOURNAL_PATH environment variable

Set PRIVATE_JOURNAL_PATH to override all journal storage to a single directory. This is useful for containerized deployments where the default home directory resolution doesn’t apply:

{
  "mcpServers": {
    "private-journal": {
      "command": "npx",
      "args": ["github:obra/private-journal-mcp"],
      "env": {
        "PRIVATE_JOURNAL_PATH": "/data/journals"
      }
    }
  }
}

When set, both project and user journals are written to the specified path, bypassing all fallback resolution logic.

--journal-path CLI argument

You can also set the project journal path via CLI argument:

npx github:obra/private-journal-mcp --journal-path /path/to/journals

This only overrides the project journal path. The user journal path still resolves via PRIVATE_JOURNAL_PATH or the default home directory logic.

MCP Tools

The server provides comprehensive journaling and search capabilities:

process_thoughts

Multi-section private journaling with these optional categories: