Allows AI agents to manage tasks, timers, expenses, invoices, and reports through a local-first work management interface.
Also known as tasktimepro/tasktime, agent-bridge, @tasktimepro/agent-bridge
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.1
- Last commit
- Nov 3, 2026
- License
- AGPL-3.0
What is TaskTime Pro MCP?
TaskTime Pro allows AI agents to manage tasks, timers, expenses, invoices, and reports through a local-first work management interface.
Summary generated from the project's README
About TaskTime Pro MCP server
TaskTime Pro Agent Bridge enables same-device AI agents to interact with the TaskTime Pro work management interface via MCP stdio. This tool acts as a communication layer that forwards tool calls to a running browser application rather than reading database files directly. Users must pair the bridge with the TaskTime Pro PWA through the Account Agent Access menu to establish a loopback app-session.
This local-first system works offline and requires no cloud sync for core functions. The bridge supports managing tasks, timers, expenses, and invoices. While basic report summaries are available for free, advanced reporting and PDF exports depend on the user's subscription level. Specific billing tools like invoice finalization and cancellation are gated by approval processes. Developers can launch the bridge using npx @tasktimepro/agent-bridge with the required app-url flag to begin the pairing process.
What you can do with it
- 1Generate monthly work summariesAsk the AI to retrieve a basic overview of your work activities for the current month.
- 2Manage invoice lifecyclesInstruct the agent to finalize or cancel specific invoices within the work manager.
- 3Verify email delivery statusRequest the agent to check if a previously sent invoice email was successfully processed.
- 4Handle invoice cancellationsDirect the agent to cancel an unpaid invoice while ensuring the source work is released.
Written from the project's README. Every use case is checked against a quote from it.
How to install TaskTime Pro MCP
Formats verified 10 Nov 2026Install TaskTime Pro MCP in Claude Code
$ claude mcp add agent-bridge -- npx -y @tasktimepro/agent-bridgeInstall TaskTime Pro MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Install TaskTime Pro MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Install TaskTime Pro MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Install TaskTime Pro MCP in Codex
~/.codex/config.toml
[mcp_servers.agent-bridge] command = "npx" args = ["-y", "@tasktimepro/agent-bridge"]
Install TaskTime Pro MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletasktimepro/tasktime is public and reachablegithub.com/tasktimepro/tasktime ↗Pass
- Package names this repository as its source@tasktimepro/agent-bridge names tasktimepro/tasktime as sourcenpmjs.com/package/@tasktimepro/agent-bridge ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @tasktimepro/agent-bridgenpmjs.com/package/@tasktimepro/agent-bridge/v/1.2.1#provenan ↗Pass
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/tasktimepro/tasktime ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @tasktimepro/agent-bridgePass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubTaskTime Pro Agent Bridge
@tasktimepro/agent-bridge provides the tasktime-agent-bridge binary used by same-device AI agents to talk to TaskTime Pro over MCP stdio.
TaskTime Pro is a free, open-source, local-first work manager for freelancers. Core use requires no TaskTime account or cloud sync, works offline after the PWA is loaded or installed, and stores work records in the browser.
The bridge does not read or write TaskTime Pro IndexedDB/Yjs data directly. It starts a loopback app-session endpoint, waits for the running TaskTime Pro browser app to pair through Account > Agent Access, and forwards MCP tool calls to the paired browser app.
Billing-scoped tools include approval-gated invoice finalization and cancellation. Cancellation is limited to finalized unpaid invoices, retains the invoice number and audit record, and releases only source work owned by that invoice.
The paired app also owns subscription policy. Free supports one active client and the closed get_report_summary({"scope":"basic-current-month"}) overview. Advanced Reports and report exports require Pro. Email preparation and PDF export remain Free, while TaskTime-hosted invoice/quote sending requires Pro and explicit confirmation. Use get_email_send_status to reconcile an ambiguous attempt without resending it.
Install and run:
npx @tasktimepro/agent-bridge --app-url https://app.tasktime.pro
Useful commands:
tasktime-agent-bridge --manifest
tasktime-agent-bridge --app-url https://app.tasktime.pro
Use --status-file only for non-secret process/endpoint discovery. Pairing IDs, pairing codes, and launch URLs remain available through interactive stderr and the get_pairing_status/refresh_pairing setup tools; the persisted status file intentionally excludes them and is removed on clean shutdown.
The current browser tab can resume a bounded app session across refresh from sessionStorage. Same-profile close/reopen continuity uses a non-exportable browser signing key and a single-use bridge challenge to obtain a fresh session. No reusable bearer token is stored durably. Explicit disconnect/revoke/disable, expiry, or bridge restart requires pairing again.
Official MCP Registry name: pro.tasktime/agent-bridge.
Public docs:
- https://tasktime.pro/agents/
- https://tasktime.pro/agents/quickstart/
- https://tasktime.pro/agents/security/
- https://tasktime.pro/agents/tools/
License: AGPL-3.0-only.
TaskTime Pro MCP questions
How do I add TaskTime Pro MCP to Claude Code?
Run claude mcp add agent-bridge -- npx -y @tasktimepro/agent-bridge in your terminal. Add --scope user to make it available in every project.
How do I add TaskTime Pro MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does the bridge access my TaskTime Pro data?
The bridge does not read or write data directly; instead, it starts a loopback app-session endpoint and forwards MCP tool calls to a paired browser app.
What features are available in the free version?
The free version supports one active client, basic current-month report summaries, email preparation, and PDF exports.
Is my session data stored durably?
No reusable bearer tokens are stored durably, and the bridge uses a single-use challenge to obtain fresh sessions for continuity.