TimeCamp

Gerencie entradas de tempo e tarefas do TimeCamp através de sua API.

GitHub
1

Documentação

[!CAUTION] Não é mais mantido. Por favor, use nosso MCP oficial https://docs.timecamp.com/mcp-server

Desenvolvedores que estão criando seu próprio servidor MCP ainda podem usar este repositório como modelo ou ponto de partida.

Servidor MCP TimeCamp

  • Por que TS e não Python? Cliente oficial, mais materiais, suporte para Cloudflare workers.
  • Por que hospedado e não apenas local? Mais fácil de usar, os usuários não precisam instalá-lo.
  • Por que Cloudflare Workers? Barato e fácil.

A versão hospedada está disponível em: https://my-mcp-server.timecamp-s-a.workers.dev

Este servidor MCP fornece as seguintes ferramentas para integração com TimeCamp:

  • add_timecamp_time_entry - Criar um novo registro de tempo com horário de início, horário de término, nota e tarefa opcional
  • get_timecamp_time_entries - Recuperar registros de tempo para um intervalo de datas especificado
  • get_timecamp_tasks - Buscar todos os projetos e tarefas disponíveis do TimeCamp
  • delete_timecamp_time_entry - Excluir um registro de tempo específico por ID
  • update_timecamp_time_entry - Atualizar um registro de tempo existente (horário, nota ou atribuição de tarefa)

Exemplo de prompt

Create Timecamp time entries based on these tasks I did. 
I write tasks by putting -HH:MM, which is the end time for the task, so each time entry should take from end end time of previous entry.
Try to match timecamp task, so first you have to fetch my timecamp tasks.
Note should be single sentence in English with 3-12 words.
Ignore "[minutes:: ...]" as this is estimate.

- [x] -9:43 emails & org [completion:: 2025-06-21]
- [x] -12:10 #tech new version of reports [[(project) XYZ]] [completion:: 2025-06-21]
- [x] -12:58 (evening) Buy shoes + relax [completion:: 2025-06-21] 
- [x] -14:30 relax [completion:: 2025-06-21]
- [x] -15:30 #tech Notifications still not working for one more person from our group [completion:: 2025-06-21]
- [x] -15:40 I don't remember [completion:: 2025-06-21] 
- [x] -17:09 #tech Client - database connection problem [[(process) Technical support]] [minutes:: 15] [completion:: 2025-06-21]
- [x] -17:35 break [completion:: 2025-06-21]
- [x] -19:17 #tech Client [[(project) Client]] [[(process) Technical support]] [minutes:: 10] [completion:: 2025-06-21]	- - [x] -19:21 (evening) Fill timesheet [completion:: 2025-06-21]

Configuração e execução

Local

pnpm start

Implantação

pnpm dlx wrangler@latest deploy
pnpm dlx wrangler@latest tail

Teste

npx mcp-remote http://localhost:8787/sse --header "Authorization: Bearer <api_token>"
npx mcp-remote https://my-mcp-server.timecamp-s-a.workers.dev/sse --header "Authorization: Bearer <api_token>"
pnpm dlx @modelcontextprotocol/inspector@latest

Conecte o Claude Desktop ao seu servidor MCP

Você também pode conectar seu servidor MCP remoto a clientes MCP locais usando o proxy mcp-remote.

Para conectar seu servidor MCP ao Claude Desktop, siga o Quickstart da Anthropic e, dentro do Claude Desktop, vá em Configurações > Desenvolvedor > Editar Configuração.

Atualize com esta configuração:

{
  "mcpServers": {
    "timecamp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://my-mcp-server.timecamp-s-a.workers.dev/sse", // or http://localhost:8787/sse
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <auth-token>"
      }
    },
    "timecamp_url": { // if MCP client supports url
      "url": "https://my-mcp-server.timecamp-s-a.workers.dev/sse",
      "headers": {
        "Authorization": "Bearer <auth-token>...."
      }
    },
  }
}

Reinicie o Claude e você verá as ferramentas disponíveis.

Se você tiver o Claude Desktop no MacOS - 'Server transport closed unexpectedly', veja https://github.com/modelcontextprotocol/servers/issues/1748#issuecomment-2896004925.

Ainda não implementado