MCP Journaling Server

View original on GitHub

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:

Header with date
Conversation transcript with timestamps
Emotional analysis
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