mtct/journaling-mcp
3.4
If you are the rightful owner of journaling-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server designed for interactive journaling with emotional analysis and automatic conversation saving.
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:
- Header with date
- Conversation transcript with timestamps
- Emotional analysis
- Reflections and recurring themes
API
Tools
start_new_session(): Start a new journaling sessionrecord_interaction(user_message, assistant_message): Record a message exchangegenerate_session_summary(summary): Generate and save session summaryget_recent_journals(): Retrieve 5 most recent entries
Resources
journals://recent: Endpoint to access recent journal entries
Prompts
start_journaling: Initial prompt
