Permite que agentes de IA gerenciem tarefas, timers, despesas, faturas e relatórios por meio de uma interface de gerenciamento de trabalho local-first.
Também conhecido como tasktimepro/tasktime, agent-bridge, @tasktimepro/agent-bridge
- Stars
- 4
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 1.2.1
- Último commit
- 3 de nov. de 2026
- Licença
- AGPL-3.0
O que é o MCP TaskTime Pro?
Permite que agentes de IA gerenciem tarefas, timers, despesas, faturas e relatórios por meio de uma interface de gerenciamento de trabalho local-first.
Resumo gerado a partir do README do projeto
Sobre o MCP server de TaskTime Pro
O TaskTime Pro Agent Bridge permite que agentes de IA no mesmo dispositivo interajam com a interface de gerenciamento de trabalho TaskTime Pro via MCP stdio. Esta ferramenta atua como uma camada de comunicação que encaminha chamadas de ferramentas para um aplicativo de navegador em execução, em vez de ler arquivos de banco de dados diretamente. Os usuários devem parear o bridge com o PWA do TaskTime Pro através do menu Account Agent Access para estabelecer uma sessão de aplicativo via loopback.
Este sistema local-first funciona offline e não requer sincronização na nuvem para as funções principais. O bridge suporta o gerenciamento de tarefas, timers, despesas e faturas. Embora resumos básicos de relatórios estejam disponíveis gratuitamente, relatórios avançados e exportações em PDF dependem do nível de assinatura do usuário. Ferramentas de faturamento específicas, como finalização e cancelamento de faturas, são controladas por processos de aprovação. Desenvolvedores podem iniciar o bridge usando npx @tasktimepro/agent-bridge com a flag app-url necessária para iniciar o processo de pareamento.
O que você pode fazer com ele
- 1Gerar resumos mensais de trabalhoPeça à IA para recuperar uma visão geral básica de suas atividades de trabalho do mês atual.
- 2Gerenciar o ciclo de vida de faturasInstrua o agente a finalizar ou cancelar faturas específicas dentro do gerenciador de trabalho.
- 3Verificar o status de entrega de e-mailSolicite ao agente que verifique se um e-mail de fatura enviado anteriormente foi processado com sucesso.
- 4Lidar com cancelamentos de faturasDirecione o agente para cancelar uma fatura não paga, garantindo que o trabalho de origem seja liberado.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP TaskTime Pro
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP TaskTime Pro no Claude Code
$ claude mcp add agent-bridge -- npx -y @tasktimepro/agent-bridgeInstalar o MCP TaskTime Pro no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Instalar o MCP TaskTime Pro no VS Code
.vscode/mcp.json
{
"servers": {
"agent-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Instalar o MCP TaskTime Pro no VS Code CLI
$ code --add-mcp '{"name":"agent-bridge","type":"stdio","command":"npx","args":["-y","@tasktimepro/agent-bridge"]}'Instalar o MCP TaskTime Pro no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Instalar o MCP TaskTime Pro no Codex
$ codex mcp add agent-bridge -- npx -y @tasktimepro/agent-bridgeInstalar o MCP TaskTime Pro no Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-bridge] command = "npx" args = ["-y", "@tasktimepro/agent-bridge"]
Instalar o MCP TaskTime Pro no Gemini CLI
$ gemini mcp add -s user agent-bridge npx -- -y @tasktimepro/agent-bridgeInstalar o MCP TaskTime Pro no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-bridge": {
"command": "npx",
"args": [
"-y",
"@tasktimepro/agent-bridge"
]
}
}
}Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessíveltasktimepro/tasktime is public and reachablegithub.com/tasktimepro/tasktime ↗Passou
- O pacote indica este repositório como sua origem@tasktimepro/agent-bridge names tasktimepro/tasktime as sourcenpmjs.com/package/@tasktimepro/agent-bridge ↗Passou
- Proveniência da build (atestação Sigstore)Sigstore attestation for @tasktimepro/agent-bridgenpmjs.com/package/@tasktimepro/agent-bridge/v/1.2.1#provenan ↗Passou
- Licença de código aberto (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-03github.com/tasktimepro/tasktime ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @tasktimepro/agent-bridgePassou
- Nenhum aviso crítico no pacote ou em suas dependências1 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP TaskTime Pro
Como adiciono o MCP TaskTime Pro ao Claude Code?
Execute claude mcp add agent-bridge -- npx -y @tasktimepro/agent-bridge no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP TaskTime Pro ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Como o bridge acessa meus dados do TaskTime Pro?
O bridge não lê nem escreve dados diretamente; em vez disso, ele inicia um endpoint de sessão de aplicativo via loopback e encaminha as chamadas de ferramentas MCP para um aplicativo de navegador pareado.
Quais recursos estão disponíveis na versão gratuita?
A versão gratuita suporta um cliente ativo, resumos básicos de relatórios do mês atual, preparação de e-mails e exportações em PDF.
Meus dados de sessão são armazenados de forma durável?
Nenhum token de portador reutilizável é armazenado de forma durável, e o bridge utiliza um desafio de uso único para obter sessões novas para continuidade.