Reads a Hermes state.db to collect what you worked on during a given ISO week, bucketed by day and work/school hours.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@berichtsheft-mcp Collect last week's Hermes logs and draft my Berichtsheft entries."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server (stdio) for the BLok online Berichtsheft.
collect_week(week) – reads a Hermes state.db and returns
what you worked on during a given ISO week, bucketed by day and by your work/school hours.
Raw data only; your agent turns it into bullet points.
fill_week(week, entries, dry_run=False) – logs into BLok with headless Playwright and appends
lines to Betriebliche Tätigkeiten / Themen der Woche / Berufsschule. Never overwrites,
skips lines that already exist, returns a screenshot path.
Intended flow: cron job collects on Friday → agent drafts → human approves → fill_week.
uv sync
mkdir -p ~/.config/berichtsheft
cp .env.example ~/.config/berichtsheft/.env && chmod 600 ~/.config/berichtsheft/.env
# edit it; either set CHROMIUM_PATH or run: uv run playwright install chromiumMCP client config (Hermes config.yaml):
mcp_servers:
berichtsheft:
command: uv
args: [--directory, /path/to/berichtsheft-mcp, run, berichtsheft-mcp]Related MCP server: time-tracker-ai-mcp
~/.config/berichtsheft/.env)Var | Example |
| your BLok login |
|
|
|
|
| default |
| optional, e.g. |
| default |
uv run pytestMIT
This server cannot be deployed
Privacy-first work tracking with summaries, reports, coaching, and AI-ready long-term memory.
Pomodoro work sessions from your AI chat: timed focus blocks, session logs.
Log and read REPS time logs, properties, and categories via MCP. Requires REPSLog Premium.
Query your trades, stats, and journal in EdgeLock and log new entries by chat. OAuth; free account.
