Journaling Server

MCP Server for journaling

Installation

Installing for Claude Desktop

Manual Configuration Required

This MCP server requires manual configuration. Run the command below to open your configuration file:

npx mcpbar@latest edit -c claude

This will open your configuration file where you can add the Journaling Server MCP server manually.

MCP Journaling Server

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

Journaling Server MCP server

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
Share:
Details:
  • Stars


    6
  • Forks


    4
  • Last commit


    5 months ago
  • Repository age


    6 months
  • License


    MIT
View Repository

Auto-fetched from GitHub .

MCP servers similar to Journaling Server:

 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


Journaling Server: MCP Server – MCP.Bar