O que clockify-mcp faz?
Servidor MCP do Clockify + plugin Claude Code: hospedado no Cloud Run com OAuth, multi-inquilino. Inclui o comando /log-session, lembrete proativo com Stop-hook e reconciliação diária de calendário.
Visão Geral
Este servidor MCP integra o Clockify com assistentes de IA, permitindo que você registre horas de trabalho diretamente por meio de comandos naturais. Ele funciona como uma ponte entre sua agenda e seu time tracker, ajudando a manter seus registros precisos e atualizados.
Funcionalidades
- Comando
/log-session: Registra sessões de trabalho no Clockify com descrição e duração. - Lembrete Proativo Stop-hook: Envia lembretes para interromper sessões ativas.
- Reconciliação Diária de Calendário: Sincroniza eventos do calendário com registros do Clockify.
Como Usar
Para usar este servidor, você precisa configurar as credenciais OAuth do Clockify e implantá-lo no Cloud Run. Depois de configurado, basta enviar comandos no formato /log-session para registrar suas horas.
Exemplo
/log-session 2h - Trabalho no projeto X
Isso registrará uma sessão de 2 horas no Clockify com a descrição "Trabalho no projeto X".
Configuração
-
Clone o repositório:
git clone https://github.com/NumacoAG/clockify-mcp.git cd clockify-mcp -
Instale as dependências:
npm install -
Configure as variáveis de ambiente:
CLOCKIFY_API_KEY: Sua chave de API do Clockify.CLOCKIFY_WORKSPACE_ID: ID do workspace do Clockify.CLIENT_ID: ID do cliente OAuth.CLIENT_SECRET: Segredo do cliente OAuth.REDIRECT_URI: URI de redirecionamento OAuth (ex.:https://seu-dominio.cloudfunctions.net/oauth/callback).
-
Implante no Cloud Run:
gcloud run deploy clockify-mcp --source .
Integração com Claude Code
No Claude Code, você pode usar este servidor MCP como um plugin. Basta adicionar a seguinte configuração ao seu arquivo claude_code.json:
{
"plugins": [
{
"name": "clockify-mcp",
"url": "https://seu-dominio.cloudfunctions.net"
}
]
}
Depois, você pode usar comandos como /log-session diretamente no chat do Claude Code.
Licença
MIT