Skip to main content
Glama

Tempo Filler MCP Server

Official
by TRANZACT
GitHub
TypeScript
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Tempo Filler MCP Server

A Model Context Protocol (MCP) server for managing Tempo worklogs in JIRA. This server enables AI assistants to interact with Tempo's time tracking system, allowing for worklog retrieval, creation, bulk operations, and management.

Table of Contents

Quick Start

  1. Get the code:
    # Clone the repository git clone https://github.com/TRANZACT/tempo-filler-mcp-server.git cd tempo-filler-mcp-server # OR download and extract the ZIP file from GitHub
  2. Build the server:
    npm install && npm run build
  3. Configure your AI assistant with:
    { "servers": { "tempo-filler": { "type": "stdio", "command": "node", "args": ["/full/path/to/tempo-filler-mcp-server/dist/index.js"], "env": { "TEMPO_BASE_URL": "https://jira.company.com", "TEMPO_PAT": "your-personal-access-token" } } } }
  4. Test it: Ask your AI assistant "Get my worklogs for this week"

How This Was Built

This MCP server was built in just 3 hours using AI-powered development tools, demonstrating the power of modern AI-assisted coding:

Development Timeline

  1. Specification Phase
    • Created the complete technical specification using GitHub Copilot with Claude Sonnet 4
    • Defined all API endpoints, data structures, and tool interfaces
    • Refined requirements through iterative conversation
  2. Implementation Phase
    • Used VS Code with Claude Code to one-shot the entire implementation
    • Generated complete TypeScript codebase, tool implementations, and client logic
    • Implemented all core functionality in a single AI-assisted session
  3. Refinement Phase
    • Switched back to GitHub Copilot with Claude Sonnet 4 after hitting usage limits in Claude Code
    • Fixed API payload formatting and authentication issues
    • Debugged and polished the Tempo API integration

Key Success Factors

  • Clear specification first: Having a detailed spec enabled effective one-shot implementation
  • AI tool synergy: Different AI tools excelled at different phases of development
  • Iterative refinement: Quick feedback loops with AI assistants for debugging

This project showcases how AI-powered development can dramatically accelerate the creation of robust, production-ready tools.

Features

  • Get Worklogs: Retrieve worklogs for users with date range and issue filtering
  • Create Worklogs: Add single worklog entries with automatic issue resolution
  • Bulk Operations: Create multiple worklog entries efficiently using concurrent processing
  • Delete Worklogs: Remove existing worklog entries
  • Resource Access: Browse worklog data and recent issues
  • Prompt Templates: Generate analysis prompts for worklog data

Installation

Prerequisites

  • Node.js (version 16 or higher)
  • npm (comes with Node.js)
  • A JIRA instance with Tempo Timesheets plugin installed
  • Personal Access Token for your JIRA account

Step-by-Step Setup

  1. Get the source code:
    # Option 1: Clone with Git git clone https://github.com/TRANZACT/tempo-filler-mcp-server.git cd tempo-filler-mcp-server # Option 2: Download ZIP # - Go to GitHub repository page # - Click "Code" → "Download ZIP" # - Extract and navigate to the folder
  2. Install dependencies:
    npm install
  3. Build the server:
    npm run build
  4. Get your JIRA credentials (see Authentication Setup below)

Configuration

The server requires environment variables for authentication and configuration:

Required Environment Variables

  • TEMPO_BASE_URL: Your JIRA instance URL (e.g., https://jira.company.com)
  • TEMPO_PAT: Personal Access Token for authentication

Optional Environment Variables

  • TEMPO_DEFAULT_HOURS: Default hours per workday (default: 8)

Creating a Personal Access Token (PAT)

  1. Log into your JIRA instance
  2. Go to Profile → Personal Access Tokens
  3. Click Create token
  4. Give it a name (e.g., "Tempo MCP Server")
  5. Set appropriate permissions (read/write access to issues and worklogs)
  6. Copy the token value for use in TEMPO_PAT

Usage with AI Assistants

GitHub Copilot Configuration (VS Code)

Add to your MCP servers configuration file (e.g., mcp.json):

{ "servers": { "tempo-filler": { "type": "stdio", "command": "node", "args": [ "/full/path/to/tempo-filler-mcp-server/dist/index.js" ], "env": { "TEMPO_BASE_URL": "https://jira.company.com", "TEMPO_PAT": "your-personal-access-token-here" } } } }

Claude Desktop Configuration

Add to your Claude Desktop config file:

{ "mcpServers": { "tempo-filler": { "command": "node", "args": ["/full/path/to/tempo-filler-mcp-server/dist/index.js"], "env": { "TEMPO_BASE_URL": "https://jira.company.com", "TEMPO_PAT": "your-personal-access-token" } } } }

Setup Steps

  1. Build the server: npm run build
  2. Find the full path to your dist/index.js file:
    # Get the full path (use pwd on macOS/Linux, cd on Windows) pwd # Should show something like /Users/yourname/tempo-filler-mcp-server
  3. Add configuration to your AI assistant (use the full path + /dist/index.js)
  4. Restart your AI assistant to load the MCP server
  5. Test the connection: Ask "Get my worklogs for this week"

Authentication Setup

The server uses Personal Access Tokens (PAT) for secure authentication:

  1. Generate a PAT in your JIRA instance:
    • Go to Profile → Personal Access Tokens
    • Create token with read/write permissions for issues and worklogs
    • Copy the token value (you won't see it again)
  2. Set environment variables:
    • TEMPO_BASE_URL: Your JIRA URL (e.g., https://jira.company.com)
    • TEMPO_PAT: Your personal access token

Available Tools

1. get_worklogs - Retrieve Time Logs

Retrieve worklogs for a date range with optional filtering.

Parameters:

  • startDate (string): Start date in YYYY-MM-DD format
  • endDate (string, optional): End date, defaults to startDate
  • issueKey (string, optional): Filter by specific issue key

Example Usage:

"Get my July hours" → Returns: Total: 184h (23 entries) • PROJ-1234: 184.0h (23 entries) "Show me my worklogs for PROJ-1234 in July" → Filters results to specific issue

2. post_worklog - Log Single Entry

Create a new worklog entry for a specific issue and date.

Parameters:

  • issueKey (string): JIRA issue key (e.g., "PROJ-1234")
  • hours (number): Hours worked (decimal, 0.1-24)
  • startDate (string): Date in YYYY-MM-DD format
  • endDate (string, optional): End date for multi-day entries
  • billable (boolean, optional): Whether time is billable (default: true)
  • description (string, optional): Work description

Example Usage:

"Log 8 hours to PROJ-1234 for July 10th" → Returns: ✅ Worklog Created Successfully Issue: PROJ-1234 - Example Project Task Hours: 8h Date: 2025-07-10 Worklog ID: 1211549

3. bulk_post_worklogs - Create Multiple Entries

Create multiple worklog entries efficiently with concurrent processing.

Parameters:

  • worklogs (array): Array of worklog objects:
    • issueKey (string): JIRA issue key
    • hours (number): Hours worked
    • date (string): Date in YYYY-MM-DD format
    • description (string, optional): Work description
  • billable (boolean, optional): Whether time is billable for all entries

Example Usage:

"Post 8 hours a day every weekday from July 11 to 15 on PROJ-1234" → Returns: ✅ Bulk Worklog Creation Started Processing 3 worklog entries... ✅ Successful: 3 ❌ Failed: 0 📊 Total Hours: 24 "Fill all weekdays in July with 8 hours on PROJ-1234" → Creates 23 entries for all weekdays in the month

4. delete_worklog - Remove Entry

Delete an existing worklog entry by ID.

Parameters:

  • worklogId (string): Tempo worklog ID to delete

Example Usage:

"Delete worklog with ID 1211547" → Removes the specified worklog entry

Example Interactions

Viewing Your Time Logs

"Get my July hours" → Returns a summary of all worklogs for July with totals by issue and date "Show me my worklogs for July 2025" → Uses get_worklogs to retrieve detailed worklog information "What did I work on last week?" → Fetches worklogs for the previous week with issue breakdown

Creating Single Worklog Entries

"Log 8 hours to PROJ-1234 for July 10th" → Creates a single worklog entry: ✅ Issue: PROJ-1234 - Example Project Task ✅ Hours: 8h (billable) ✅ Date: 2025-07-10 ✅ Worklog ID: 1211549 "Post 6.5 hours on PROJ-123 for today with description 'Bug fixes and testing'" → Uses post_worklog with custom description

Bulk Worklog Creation

"Post 8 hours a day every weekday from July 11 to 15 on PROJ-1234" → Creates 5 worklog entries (skips weekends): ✅ July 11 (Friday): 8h ✅ July 14 (Monday): 8h ✅ July 15 (Tuesday): 8h Total: 24 hours across 3 weekdays "Fill my timesheet for this week - 4 hours PROJ-1111 and 4 hours PROJ-2222 each day" → Uses bulk_post_worklogs with multiple issues per day "Finish filling up the days until July 31st" → Automatically fills remaining weekdays in the month

Advanced Bulk Operations

"Log time for the entire month of July: - PROJ-1234: 8 hours every weekday - Skip weekends - All time should be billable" → Creates 22 worklog entries for all weekdays in July "Fill my Q2 timesheet with 8 hours daily split between: - 60% on PROJ-1234 (development) - 40% on PROJ-5678 (meetings)" → Calculates hours and creates entries for the quarter

Worklog Management

"Delete worklog with ID 1211547" → Removes the specified worklog entry "Show me a summary of my July hours by issue" → Groups worklogs by issue with totals and percentages

Real-World Usage Examples

Based on successful implementation, here are practical scenarios:

Daily Time Logging

# Using VS Code with GitHub Copilot: User: "Log 8 hours on PROJ-1234 for today" AI: ✅ Worklog Created Successfully Issue: PROJ-1234 - Example Project Task Hours: 8h Date: 2025-08-01 Worklog ID: 1211550 Time Spent: 1d

Monthly Time Filling

# Bulk operation for entire month: User: "Fill all weekdays in July with 8 hours on PROJ-1234" AI: ✅ Bulk Worklog Creation Started Processing 23 worklog entries... ✅ Successful: 23 ❌ Failed: 0 📊 Total Hours: 184

Time Tracking Analysis

# Monthly summary: User: "Get my July hours" AI: 📊 Total Hours: 184 hours (23 entries) Breakdown by issue: • PROJ-1234: 184.0h (23 entries) Daily pattern: 8 hours per weekday Completion: 100% (all weekdays filled)

Development

Project Structure

src/ ├── index.ts # Main MCP server entry point ├── tempo-client.ts # Tempo API client with PAT auth ├── tools/ # Tool implementations │ ├── get-worklogs.ts │ ├── post-worklog.ts │ ├── bulk-post.ts │ └── delete-worklog.ts └── types/ # TypeScript type definitions ├── tempo.ts ├── mcp.ts └── index.ts

Build Commands

  • npm run build: Compile TypeScript to JavaScript
  • npm run dev: Build and run the server
  • npm run typecheck: Type checking without compilation

Testing

The server can be tested using the MCP Inspector or by integrating with compatible AI assistants.

Security

  • Personal Access Tokens are used for secure authentication
  • No credentials are logged or exposed
  • Input validation is performed on all parameters
  • Rate limiting and error handling protect against API abuse

API Compatibility

This server is compatible with:

  • JIRA Core/Software 8.14+
  • Tempo Timesheets 4.x
  • Model Context Protocol specification

Troubleshooting

Setup Issues

Server not found / Path issues:

  • Ensure you're using the full absolute path to dist/index.js
  • On Windows: C:\Users\YourName\tempo-filler-mcp-server\dist\index.js
  • On macOS/Linux: /Users/YourName/tempo-filler-mcp-server/dist/index.js
  • Verify the file exists: ls dist/index.js (should show the file)

Build failures:

  • Check Node.js version: node --version (should be 16+)
  • Clear cache and retry: npm cache clean --force && npm install && npm run build
  • Check for error messages in the build output

AI Assistant not loading the server:

  • Restart your AI assistant completely after adding the configuration
  • Check the configuration file syntax (valid JSON)
  • Verify environment variables are set correctly

Authentication Issues

  • Verify your Personal Access Token is valid and has proper permissions
  • Check that your JIRA instance URL is correct
  • Ensure Tempo is properly installed and configured in your JIRA instance

Connection Issues

  • Verify network connectivity to your JIRA instance
  • Check firewall and proxy settings
  • Confirm the JIRA instance is accessible from your environment

Permission Issues

  • Ensure your user account has permission to log time to the specified issues
  • Verify Tempo is configured to allow time logging for your user
  • Check project permissions in JIRA

License

ISC License - see package.json for details

Contributing

Contributions are welcome! Please follow the existing code style and ensure all tools work correctly with real Tempo API endpoints.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server enabling AI assistants to interact with Tempo's time tracking system in JIRA for worklog retrieval, creation, and management.

  1. Table of Contents
    1. Quick Start
      1. How This Was Built
        1. Development Timeline
        2. Key Success Factors
      2. Features
        1. Installation
          1. Prerequisites
          2. Step-by-Step Setup
        2. Configuration
          1. Required Environment Variables
          2. Optional Environment Variables
          3. Creating a Personal Access Token (PAT)
        3. Usage with AI Assistants
          1. GitHub Copilot Configuration (VS Code)
          2. Claude Desktop Configuration
          3. Setup Steps
          4. Authentication Setup
        4. Available Tools
          1. 1. get_worklogs - Retrieve Time Logs
          2. 2. post_worklog - Log Single Entry
          3. 3. bulk_post_worklogs - Create Multiple Entries
          4. 4. delete_worklog - Remove Entry
        5. Example Interactions
          1. Viewing Your Time Logs
          2. Creating Single Worklog Entries
          3. Bulk Worklog Creation
          4. Advanced Bulk Operations
          5. Worklog Management
        6. Real-World Usage Examples
          1. Daily Time Logging
          2. Monthly Time Filling
          3. Time Tracking Analysis
        7. Development
          1. Project Structure
          2. Build Commands
          3. Testing
        8. Security
          1. API Compatibility
            1. Troubleshooting
              1. Setup Issues
              2. Authentication Issues
              3. Connection Issues
              4. Permission Issues
            2. License
              1. Contributing

                Related MCP Servers

                • Jira MCP Server

                  samuelrizzo
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
                  Last updated -
                  7
                  24
                  1
                  TypeScript
                  MIT License
                  • Linux
                  • Apple

                • Jira MCP Server

                  maximepeabody
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.
                  Last updated -
                  1
                  Python
                  Apache 2.0

                • MCP Jira

                  TusharShahi
                  -
                  security
                  F
                  license
                  -
                  quality
                  Model Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.
                  Last updated -
                  Python

                • MCP JIRA Server

                  codingthefuturewithai
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants to create and manage JIRA issues with rich markdown formatting and automatic conversion to Atlassian Document Format.
                  Last updated -
                  4
                  Python
                  • Linux
                  • Apple

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/TRANZACT/tempo-filler-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server