Tempo MCP Server
About
An MCP server for managing Tempo worklogs in Jira. It connects to Jira and Tempo services using API tokens and environment variables.
Details
- Author
- ivelin-web
- GitHub stars
- 41
- Downloads
- 493
- Categories
- Productivity, Project Management, Automation, Other, AI
Jump to
- Retrieve worklogs for a date range
- Create, edit, and delete worklogs
- Bulk create multiple worklogs in one operation
- Missing days report (respects holidays via Tempo user-schedule)
- Worklog analytics aggregated by issue, account, day, week, or month
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Tempo MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Use one of three modes: deploy remotely on Cloudflare Workers (no install, each user gets a personal URL), run directly with npx, or clone the repository locally. Configure environment variables TEMPO_API_TOKEN, JIRA_API_TOKEN, JIRA_EMAIL, and JIRA_BASE_URL.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"tempo mcp server": {
"tempo-mcp-server": {
"command": "npx",
"args": [
"wrangler",
"login"
]
}
}
}
}McpServers
{
"tempo-mcp-server": {
"command": "npx",
"args": [
"wrangler",
"login"
]
}
}Tempo MCP Server
A Model Context Protocol (MCP) server for managing Tempo worklogs in Jira. This server provides tools for tracking time and managing worklogs through Tempo's API, making it accessible through Claude, Cursor and other MCP-compatible clients.
Features
- Retrieve Worklogs: Get all worklogs for a specific date range
- Create Worklog: Log time against Jira issues
- Bulk Create: Create multiple worklogs in a single operation
- Edit Worklog: Modify time spent, dates, and descriptions
- Delete Worklog: Remove existing worklogs
- Missing Days Report: Find working days where you logged less than expected (uses Tempo's user-schedule, so holidays and non-working days are skipped automatically)
- Worklog Analytics: Aggregate hours by issue, account, day, week, or month with totals and percentages
System Requirements
- Node.js 18+ (LTS recommended) — only needed for the local stdio modes
- Jira Cloud instance
- Tempo API token
- Jira API token (not required when using OAuth 2.0 PKCE authentication)
Usage Options
There are three ways to use this MCP server:
1. Remote / Cloudflare Workers (no install) — host once, share with your team. Each user generates their own URL via a setup page and pastes it into Claude.ai or ChatGPT. Works from web and mobile.
2. NPX: Run directly with npx on your laptop, no clone required.
3. Local Clone: Clone the repository for development or customization.
If you just want to use the server, option 1 is the easiest and works on phones too. If you're a maintainer deploying for your team, see the Remote deployment guide.
Option 1: Remote (Cloudflare Workers)
For end users
Once your team has the server deployed, the flow is:
1. Open https://<your-deployment>.workers.dev/setup.
2. Paste your Tempo API token, Jira base URL, Jira API token, and Jira email. Hit Generate MCP URL.
3. The page returns a personal URL like https://<your-deployment>.workers.dev/mcp/u_<random>. Copy it.
4. In Claude.ai → Settings → Connectors → Add custom connector, paste the URL.
5. The connector syncs across web, desktop, and mobile (iOS/Android).
For ChatGPT: enable Settings → Apps → Advanced → Developer mode (Pro/Plus/Business+), then add the URL as a custom MCP server. Plus/Pro accounts can read; write tools (create/edit worklogs) require Business+ per OpenAI's tier.
The URL contains your credentials — treat it like a password, don't share or commit it.
Remote deployment (Cloudflare Workers)
Free-tier hosting on Cloudflare Workers. ~5–10 minutes from clone to live URL. Anyone can fork and self-host — no upstream coordination needed.
Prerequisites
- A Cloudflare account (free plan is enough).
- Node.js 18+ and npm locally — only used for wrangler CLI; the Worker runtime itself doesn't run Node.
One-time setup
```bash
git clone https://github.com/ivelin-web/tempo-mcp-server.git
cd tempo-mcp-server
npm install
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
