parallelhours-mcp

MCP (Model Context Protocol) server for parallelhours.io — translates MCP tool calls into REST API requests.

Installation

uvx parallelhours-mcp

Or install as a package:

pip install parallelhours-mcp

Configuration

Environment Variables

Variable	Required	Default	Description
`TKPI_PAT`	Yes	—	Your Personal Access Token from parallelhours.io
`TKPI_BASE_URL`	No	`https://parallelhours.io`	Base URL of the parallelhours instance
`TKPI_PROJECT`	No	—	Default project key for task operations

Claude Code Configuration

Add to your .mcp.json:

{
  "mcpServers": {
    "parallelhours": {
      "command": "uvx",
      "args": ["parallelhours-mcp"],
      "env": {
        "TKPI_PAT": "${TKPI_PAT}",
        "TKPI_PROJECT": "TKPI"
      }
    }
  }
}

Available Tools

list_projects — List all projects
get_active_timers — List running timers
start_timer — Start a timer on a task
stop_timer — Stop a running timer
increment_prompt_count — Increment prompt count
log_ai_event — Log AI usage events
list_tasks — List tasks in a project
get_task_context — Get task details with timers
get_task_kpis — Get task KPI metrics
create_task — Create a new task
update_task — Update an existing task

Usage

export TKPI_PAT="your-pat-token"
uvx parallelhours-mcp

Development

# Clone and setup
git clone https://github.com/pmonday/time-kpi.git
cd time-kpi

# Install dependencies
uv sync

# Run locally
python -m parallelhours_mcp

License

MIT

Metadata

Release files for parallelhours-mcp 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for parallelhours-mcp 0.2.1
File	Size	Uploaded	Provenance
parallelhours_mcp-0.2.1.tar.gz	8.6 kB	Jul 22, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for parallelhours-mcp 0.2.1
File	Interpreter	ABI	Platform	Reset
parallelhours_mcp-0.2.1-py3-none-any.whl 8.3 kB Jul 22, 2026 With provenance	Python 3	none	any	Details

Total release size: 16.9 kB

Release files / parallelhours_mcp-0.2.1.tar.gz

Download URL	parallelhours_mcp-0.2.1.tar.gz
Size	8.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`fcdb82fef87cbaee0074b9e59e7dc6c346069e6e3cf2a80a37676c0d61058347`
BLAKE2b-256 checksum How to use checksums	`11bddb3068a23d810bfd67c6dd486e5e4132b4de12e78cac7b33d1316b5bbca1`
Upload date	Jul 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pmonday/time-kpi
Publishing commit: github.com/pmonday/time-kpi/tree/79008b5e5204e58c49e1f7bcc4ba256b40265e30

Workflow

Publishing configuration: github.com/pmonday/time-kpi/blob/79008b5e5204e58c49e1f7bcc4ba256b40265e30/.github/workflows/publish.yml
Publishing logs: github.com/pmonday/time-kpi/actions/runs/29940086089/attempts/1

Artifact

Subject: parallelhours_mcp-0.2.1.tar.gz
SHA-256 checksum: fcdb82fef87cbaee0074b9e59e7dc6c346069e6e3cf2a80a37676c0d61058347 Verifying attestations

Release files / parallelhours_mcp-0.2.1-py3-none-any.whl

Download URL	parallelhours_mcp-0.2.1-py3-none-any.whl
Size	8.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7506aec5b96e744a061d43be4e94dc360c32e9f015bd6e0f6f85f222ad4b34f3`
BLAKE2b-256 checksum How to use checksums	`afd8f67e49f39e62cea5de55794a1f5a08a545a3e4473cdce0810e270dcb3fcd`
Upload date	Jul 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pmonday/time-kpi
Publishing commit: github.com/pmonday/time-kpi/tree/79008b5e5204e58c49e1f7bcc4ba256b40265e30

Workflow

Publishing configuration: github.com/pmonday/time-kpi/blob/79008b5e5204e58c49e1f7bcc4ba256b40265e30/.github/workflows/publish.yml
Publishing logs: github.com/pmonday/time-kpi/actions/runs/29940086089/attempts/1

Artifact

Subject: parallelhours_mcp-0.2.1-py3-none-any.whl
SHA-256 checksum: 7506aec5b96e744a061d43be4e94dc360c32e9f015bd6e0f6f85f222ad4b34f3 Verifying attestations

Security for parallelhours-mcp 0.2.1

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for parallelhours_mcp-0.2.1.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pmonday/time-kpi
Publishing commit: github.com/pmonday/time-kpi/tree/79008b5e5204e58c49e1f7bcc4ba256b40265e30

Workflow

Publishing configuration: github.com/pmonday/time-kpi/blob/79008b5e5204e58c49e1f7bcc4ba256b40265e30/.github/workflows/publish.yml
Publishing logs: github.com/pmonday/time-kpi/actions/runs/29940086089/attempts/1

Artifact

Subject: parallelhours_mcp-0.2.1.tar.gz
SHA-256 checksum: fcdb82fef87cbaee0074b9e59e7dc6c346069e6e3cf2a80a37676c0d61058347 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.