Metadata-Version: 2.4
Name: mseep-journaling-mcp
Version: 0.1.1
Summary: Add your description here
Home-page: 
Author: mseep
Author-email: mseep <support@skydeck.ai>
Maintainer-email: mseep <support@skydeck.ai>
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: python-dotenv>=1.0.1
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# MCP Journaling Server

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

<a href="https://glama.ai/mcp/servers/kiay3i2li7"><img width="380" height="200" src="https://glama.ai/mcp/servers/kiay3i2li7/badge" alt="Journaling Server MCP server" /></a>

## 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


