# TaskTime Pro

Bridges local AI agents with the TaskTime Pro manager over stdio. Helps track work time, inspect project expenses, and manage client invoices right from your editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 4
- Author: tasktimepro
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tasktimepro/tasktime/tree/HEAD/agent-bridge
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/mcp/tasktime-pro

## What it does

The server runs `@tasktimepro/agent-bridge` over standard input/output. It never reads local IndexedDB files directly. Instead, it hosts a loopback endpoint and waits for the browser app to pair via the Account > Agent Access screen, relaying agent calls into the active PWA session.

Agents can inspect tasks, active timers, and invoices. Actions that alter billing enforce guardrails: canceling an unpaid finalized invoice preserves its audit trail and invoice number while unlocking assigned work items. Without a running browser tab paired via Account > Agent Access, the bridge cannot execute commands, as no long-lived bearer tokens are saved to disk.

Plan boundaries stay inside the paired browser app. The free tier covers one active client and the current month report summary. Generating invoice PDFs and drafting emails work on Free, but sending documents directly through TaskTime infrastructure requires a Pro subscription.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-bridge -- npx -y @tasktimepro/agent-bridge
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-bridge -- npx -y @tasktimepro/agent-bridge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "@tasktimepro/agent-bridge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tasktimepro/agent-bridge"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-bridge npx -y @tasktimepro/agent-bridge
```

## When to use it
- manage task timers and log billable hours
- generate and finalize client invoices
- check monthly expense summaries and basic reports
- prepare email drafts and export invoice PDFs

## Example prompts
- Check my active timers and list unfinished tasks in TaskTime Pro
- Create a finalized invoice for the current client and export the PDF
- Run `get_email_send_status` to see if the quote reached the client

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md