Skip to main content
Glama
Sign In
enesjakozh

MCP Journaling Server

by mtct
GitHub
Python
MIT License
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • The server can be configured using environment variables in a .env file, allowing customization of journal directory, filename prefix, and file extension.

  • The server saves conversations in Markdown format, with journal entries stored as .md files that include formatted conversations with timestamps, emotional analysis, and reflections.

  • The server supports temporal analysis of conversations with timestamps, providing chronological organization of journal entries.

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

The MCP server transforms chats with Claude into journaling sessions, saving conversations locally and allowing the LLM to retrieve previous sessions to create continuity in discussions about daily activities.

  1. Features
    1. Installation
      1. Configuration
        1. File Structure
          1. Entry Format
            1. API
              1. Tools
              2. Resources
              3. Prompts

            Related Resources

            Related MCP Servers

            • Knowledge Graph Memory Server

              yodakeisuke
              A
              security
              F
              license
              A
              quality
              This MCP server provides persistent memory integration for chat applications by utilizing a local knowledge graph to remember user information across interactions.
              Last updated -
              9
              7,903
              1
              JavaScript

            • mcp-server-llmling

              phil65
              -
              security
              A
              license
              -
              quality
              A server for the Machine Chat Protocol (MCP) that provides a YAML-based configuration system for LLM applications, allowing users to define resources, tools, and prompts without writing code.
              Last updated -
              5
              Python
              MIT License

            • ClaudeKeep

              sdairs
              A
              security
              A
              license
              A
              quality
              An MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.
              Last updated -
              2
              6
              TypeScript
              MIT License
              • Apple

            • MCP Server Memory File

              g0t4
              -
              security
              F
              license
              -
              quality
              An MCP server that allows Claude and other LLMs to manage persistent memories across conversations through text file storage, enabling commands to add, search, delete and list memory entries.
              Last updated -
              2
              TypeScript

            View all related MCP servers

            Appeared in Searches

            ID: kiay3i2li7