Journaling MCP

🚀 MCP Journaling Server

An MCP (Message Control Protocol) server designed to handle interactive journaling sessions, supporting sentiment analysis and automatic conversation saving.

🚀 Quick Start

This MCP server is tailored for managing interactive journaling sessions, offering features like sentiment analysis and automatic conversation archiving.

✨ Features

• Automated management of journaling sessions.
• Conversations are saved in Markdown format.
• Temporal analysis of conversations with timestamps.
• Support for reading recent journal entries.
• Log entries are organized chronologically.

📦 Installation

From your MCP client, configure the dependencies using Claude Desktop:

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

📚 Documentation

Configuration

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

• JOURNAL_DIR: Directory to save journal files (Default: ~/Documents/journal).
• FILENAME_PREFIX: Prefix for filenames (Default: "journal").
• FILE_EXTENSION: Extension for journal files (Default: ".md"). If not specified, default values will be used.

File Structure

Journal entries are saved in the following structure:

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

Entry Format

Each journal entry includes:

1. Date header
2. Timestamped conversation records
3. Sentiment analysis
4. Reflections and recurring themes

📄 API Documentation

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 a session summary.
• get_recent_journals(): Retrieve the last 5 entries.

Resources

• journals://recent: Endpoint to access recent journals.

Prompts

• start_journaling: Initial prompt