MCP Journaling

MCP Journaling Server

An MCP (Message Control Protocol) server designed to handle interactive journaling sessions with support for emotional analysis and automatic conversation saving.

Features

• Automatic journaling session management
• Conversation saving in Markdown format
• Temporal analysis of conversations with timestamps
• Support for reading recent journal entries
• Chronological organization of journal entries

Installation

Depend from your MCP client, on Claude Desktop:

    "mcpServers": {
        "journaling": {
            "command": "uv",
            "args": [
                "--directory",
                <REPOSITORY PATH>,
                "run",
                "server.py"
            ]
        }
    }

Configuration

The server can be configured using environment variables in .env file:

• JOURNAL_DIR: Directory for saving journal files (default: ~/Documents/journal)
• FILENAME_PREFIX: Prefix for file names (default: "journal")
• FILE_EXTENSION: Journal file extension (default: ".md")

If not specified, default values will be used.

File Structure

Journal entries are saved with the following structure:

[JOURNAL_DIR]/
├── journal_2025-01-27.md
├── journal_2025-01-26.md
└── ...

Entry Format

Each journal entry includes:

1. Header with date
2. Conversation transcript with timestamps
3. Emotional analysis
4. Reflections and recurring themes

API

Tools

• start_new_session(): Start a new journaling session
• record_interaction(user_message, assistant_message): Record a message exchange
• generate_session_summary(summary): Generate and save session summary
• get_recent_journals(): Retrieve 5 most recent entries

Resources

• journals://recent: Endpoint to access recent journal entries

Prompts

• start_journaling: Initial prompt