Skip to content

Quickstart

In a few minutes: install the server, point it at your notes, confirm it finds them, and let an assistant write the first line.

1. Install

uv tool install worklog-mcp

This puts a worklog-mcp command on your PATH. Nothing else is needed — the server has no state and no configuration file of its own.

2. Confirm it finds your log

Before wiring anything into a client, ask the command itself:

worklog-mcp check --dir ~/notes

ok: file="2026-09-06.md" items=3

That is the file an append would write to, and the number of items its first checklist already holds. If the answer is not ok, the CLI page maps each exit code to what is missing.

If the directory holds more than logs, narrow it down with a regular expression matched against file names:

worklog-mcp check --dir ~/notes --pattern '^\d{4}-\d{2}-\d{2}\.md$'

3. Add it to your client

{
  "mcp": {
    "worklog": {
      "type": "local",
      "command": ["worklog-mcp", "serve", "--dir", "/path/to/your/notes"]
    }
  }
}

claude mcp add worklog -- worklog-mcp serve --dir /path/to/your/notes

{
  "mcpServers": {
    "worklog": {
      "command": "worklog-mcp",
      "args": ["serve", "--dir", "/path/to/your/notes"]
    }
  }
}

Restart the client. Two tools appear, append and check, prefixed with the name you gave the server.

4. Write the first line

Ask the assistant to record what it just did. It calls append with one sentence, and reports back the file and the line:

one item was appended to the checklist in "2026-09-06.md"
- [x] fixed the CSV import in the reports service, an unhandled empty row

Ask it again with the same sentence and nothing happens — the call comes back as duplicate. To see the line without writing it, the tool takes dry_run.

Next