worklog-notion

worklog-notion

A Claude Code plugin that automatically logs your daily git commits to a Notion work log database.

One command. No manual writing. Year-end review ready.

What it does

1. Pulls git log for today, filtered to your git author
2. Groups commits by ticket ID (e.g. SOFTDEV-19381) extracted from branch names
3. Claude infers: description, impact, category (Feature/Bug Fix/Migration/etc.), wins flag, and skills
4. Writes structured rows to your Notion Work Log database
5. Reminds you at end of each Claude Code session if commits are unlogged

Setup

1. Install the plugin

Clone this repo into ~/claude-plugins/worklog-notion:

git clone <this-repo-url> ~/claude-plugins/worklog-notion

Then register the parent folder as a local marketplace (one-time step) and install:

claude plugin marketplace add ~/claude-plugins
claude plugin install worklog-notion

The plugin is installed at user scope — available in all projects permanently.

If you already have a local marketplace at ~/claude-plugins, skip the marketplace add step and just run claude plugin install worklog-notion.

If ~/claude-plugins doesn't exist yet, the clone step above creates it. The marketplace add command will pick up the .claude-plugin/marketplace.json file included in this repo, which registers worklog-notion as an available plugin.

You can verify the marketplace was added with:

claude plugin marketplace list

And confirm the plugin installed correctly with:

claude plugin list

2. Configure your Notion page

Open ~/.claude/settings.json and add your Notion page ID under pluginOptions:

{
  "pluginOptions": {
    "worklog-notion@local-plugins": {
      "notion_page_id": "your-page-id-here"
    }
  }
}

Your page ID is the hex string at the end of your Notion page URL: https://notion.so/Log-book-2026-your-page-id-here → your-page-id-here

Requirement: Your Notion MCP must be authorized (company setup handles this).

3. (Optional) Override git author

By default the plugin uses git config user.name. To override, add git_author to the same block in ~/.claude/settings.json:

{
  "pluginOptions": {
    "worklog-notion@local-plugins": {
      "notion_page_id": "your-page-id-here",
      "git_author": "Your Name"
    }
  }
}

Usage

Manual (end of day)

/worklog

Claude will pull today's commits, infer everything, and write to Notion in ~30 seconds.

Automatic reminder

Every time you end a Claude Code session, the plugin checks if you have unlogged commits. If you do, it prints a reminder in your terminal:

[worklog-notion] 3 unlogged commit(s) today.
  Run /worklog in Claude Code to log them to Notion.

Notion database schema

The plugin creates a Work Log database inside your configured page with:

Column	Type	Description
Ticket	Title	Ticket ID (e.g. SOFTDEV-19381)
Date	Date	The day the work was done
Description	Text	What was done (inferred)
Impact	Text	Business/technical value (inferred)
Category	Select	Feature, Bug Fix, Migration, Architecture, Docs, Review, Chore
Wins	Checkbox	Notable achievement worth mentioning in a review
Skills	Multi-select	React, Redux, RTK Query, Architecture, API Design, Saga, Docs, Data Formatting, Testing, Styling

The database is created automatically on first /worklog run if it doesn't exist.

Year-end review workflow

1. Open your Notion log book page
2. Filter Work Log by Wins = true → instant highlight reel
3. Group by Category → see your work distribution
4. Filter by Skills → build your technical narrative