MCP Server: Productivity Cop

An MCP (Model Context Protocol) server that integrates Jira, Tempo Timesheets, and GitHub Enterprise to provide comprehensive productivity tracking and analysis.

Features

• User Lookup: Find user IDs across all platforms by name
• Jira Integration: Fetch tickets and activity within timeframes
• Tempo Integration: Retrieve timesheet entries and work logs
• GitHub Integration: Track PRs, commits, comments, and reviews

Prerequisites

• Bun runtime (https://bun.sh)
• Access to Jira, Tempo, and GitHub Enterprise APIs
• Valid API tokens for each service

Installation

bun install

Configuration

1. Copy .env.example to .env
2. Fill in your API credentials and endpoints
3. (Optional) Set JIRA_USER_CUSTOM_FIELD if your Jira instance uses a custom field for user associations (defaults to cf[21860])

Claude Desktop Integration

Automatic Installation

Run the install script to automatically configure Claude Desktop:

# Using npm script (recommended)
bun run install:claude

# Or run directly
bun run install-mcp.js

# Or use the shell script (macOS only)
./install-mcp.sh

Manual Installation

Add the following to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "productivity-cop": {
      "command": "bun",
      "args": ["/absolute/path/to/server-productivity-cop/dist/server.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

After installation, restart Claude Desktop to load the MCP server.

Development

bun run dev

Build

bun run build

Usage

This server exposes the following MCP tools:

• find_user: Search for a user by name across platforms (returns first match)
• get_jira_activity: Fetch Jira tickets and activity
• get_tempo_timesheets: Retrieve timesheet entries
• get_github_activity: Track GitHub contributions

See the technical specification in spec.md for detailed API documentation.