start_new_sessionLABSCO SUMMARY
The conversation becomes the journal entry.
Rather than journaling and then talking about it, the session is the entry: timestamped as it happens, summarised when it closes, and left on disk as Markdown you can read without this server.
What it is
A journaling MCP server that saves interactive sessions as Markdown files. Each exchange is recorded with its timestamp, and closing a session writes a dated header, the transcript, an emotional analysis and the recurring themes into a file in your journal directory.
What you get
- A journaling session started and closed on demand
- Each exchange recorded with its timestamp
- A session summary written into the entry, with emotional analysis and recurring themes
- The five most recent entries read back
- Entries stored as dated Markdown files, also reachable at journals://recent
Requirements
Python with uv, pointed at a local checkout. Entries are written to a journal directory, which defaults to ~/Documents/journal and can be pointed elsewhere; the filename prefix and file extension are configurable. No account, no key.
Setup effort
Clone and run — clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build
USE CASES
01
Journaling by talking rather than typing into a file
Start a session, and each exchange lands in today's entry with its timestamp.
02
Closing the day out
Generate the summary, which writes the reflection and the recurring themes into the file.
03
Picking up where you left off
Read the five most recent entries before starting a new one.
04
Keeping the record somewhere you control
Entries are plain Markdown under your own journal directory, readable with or without this server.
4 tools
Listed in project docs. Your client may show a different list.
record_interactiongenerate_session_summaryget_recent_journalsBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/mtct/journaling-mcp.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"journaling": {
"command": "uv",
"args": [
"--directory",
"<YOUR_REPOSITORY_PATH>",
"run",
"server.py"
]
}
}
}
