Scans git repositories to extract commit history and automatically generate timesheets by parsing Jira issue keys from commit messages and distributing time based on commit activity.
Integrates with Tempo time tracking in Jira to create, update, and delete worklogs, automatically fetch account information from issues, and retrieve work attributes and roles. Includes automatic timesheet generation from git commits.
Tempo MCP Server
MCP (Model Context Protocol) server for Tempo time tracking with full support for roles and accounts.
Features
Auto-generate timesheets from git commits - scans all your repos and creates worklogs automatically
Create worklogs with role and account attributes
Automatically fetch account from Jira issue
Auto-fallback to active account when issue's account is closed/archived
Quick sprint meeting logging - just specify project and minutes
Update and delete worklogs
List worklogs for date ranges
Get available work attributes and roles
Installation
Configuration
Getting your API tokens
Tempo API Token:
Go to Tempo > Settings in your Jira instance
Click on API Integration in the left sidebar
Click New Token
Give it a name (e.g., "Claude Code MCP")
Select permissions: Manage Worklogs (or Full Access)
Copy the generated token
Jira API Token:
Go to Atlassian API Tokens
Click Create API token
Give it a label (e.g., "Claude Code MCP")
Copy the generated token
Environment Variables
Variable | Required | Description |
| Yes | Tempo API token (get from Tempo > Settings > API Integration) |
| Yes | Jira API token (get from id.atlassian.com/manage-profile/security/api-tokens) |
| Yes | Jira account email |
| Yes | Jira base URL (e.g., https://company.atlassian.net) |
| No | Custom field ID for Tempo account (default: 10026) |
| No | Default role for worklogs (default: Dev) |
| No | Default directory for git repos (e.g., C:/Users/you/Projects) |
| No | Jira issue for Monday team meeting (default: BS-14) |
Note:
gitAuthordefaults toJIRA_EMAILsince they're the same for all developers.
Usage with Claude Code
Quick Setup (one command)
Linux/macOS:
Windows (PowerShell):
Example configuration in claude.json
Available Tools
tempo_generate_timesheet
The main feature! Automatically generate your weekly timesheet from git commits.
Parameter | Required | Description |
| Yes | Monday date of the week (YYYY-MM-DD) |
| Yes | Your git author email or name |
| Yes | Directory containing all your git repositories |
| No | If true, shows plan without creating worklogs (default: false) |
| No | Jira issue for Monday team meeting (default: BS-14) |
What it does:
Scans all git repos in
projectsDirExtracts your commits for Monday-Thursday
Parses Jira issue keys from commit messages (e.g.,
PROJ-123)Distributes 8h/day based on commit count per issue
Adds 15min daily sprint meeting (on the main project of the day)
Adds 15min Monday team sync on BS-14
Generates client-friendly descriptions from commit messages
Creates worklogs in Tempo
Example usage in Claude Code:
"fait ma feuille de temps de cette semaine"
"generate my timesheet for last week"
"do my timesheet for the week of december 1st in dry run mode"
Important: Your commit messages should include Jira issue keys (e.g., PROJ-123 fix: description). Commits without issue keys will be flagged as warnings.
tempo_log_sprint_meeting
Quick way to log time for sprint meetings (daily, planning, retro). Automatically finds the "Sprint Meetings" issue for the project.
Example usage in Claude Code:
"add 15 mins for sprint meetings for BERGA"
"log daily 15 mins to CRC project"
tempo_create_worklog
Create a new worklog with role and account support.
If accountKey is not provided, it will be automatically fetched from the Jira issue. If the account is closed/archived, it will automatically find an active account from recent project issues.
tempo_get_worklogs
Retrieve worklogs for a date range.
tempo_update_worklog
Update an existing worklog.
tempo_delete_worklog
Delete a worklog.
tempo_get_work_attributes
Get available work attributes (roles, accounts configuration).
tempo_get_roles
Get available Tempo roles.
License
MIT