convez.ai
MCP ServerIntegração & APIsIntermediário
Kos-M

Tempus MCP – Integração Toggl Track

Kos-M/tempus-mcp

Controle Toggl Track por IA — time entries, projetos e workspaces

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta Claude e outros assistentes IA ao Toggl Track para gerenciar registros de tempo, projetos e workspaces por linguagem natural. Permite criar, atualizar e deletar time entries, inclusive retroativas, além de gerenciar projetos e consultar dados de workspace.

Instalação

$npx convez-ai Kos-M/tempus-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Criar registros de tempo retroativos por comando de voz/texto
  • Automatizar relatórios e consultas de time entries via assistentes IA
  • Gerenciar projetos e atribuições de horas sem sair do fluxo de conversação

Veredito

Integração bem estruturada com o Toggl Track, cobrindo CRUD completo de time entries e projetos. Útil para quem usa Toggl e quer automação IA, mas requer token de API e configuração manual em clientes MCP.

README

A tradução para o português deste README ainda está na fila.

Tempus MCP ⏱️

Tempus (Latin for "time") — An MCP server for Toggl Track.

A Model Context Protocol (MCP) server that provides AI assistants with full access to your Toggl Track time tracking data. Create time entries for past dates, manage projects, query workspaces, and more — all through natural language.

Tools

Time Entries

ToolDescription
toggl_list_time_entriesList time entries with optional date filtering
toggl_get_current_time_entryGet the currently running time entry
toggl_create_time_entryCreate time entries for any date (past or future) with project assignment, tags, and billable status
toggl_update_time_entryUpdate existing time entries (description, project, start/stop, duration)
toggl_delete_time_entryPermanently delete a time entry
toggl_stop_time_entryStop a running time entry

Projects

ToolDescription
toggl_list_projectsList all projects in a workspace
toggl_get_projectGet a single project by ID
toggl_create_projectCreate a new project

Workspaces & User

ToolDescription
toggl_list_workspacesList all accessible workspaces
toggl_get_workspaceGet workspace details
toggl_get_meGet authenticated user profile
toggl_list_clientsList clients in a workspace

Installation

npm install -g tempus-mcp
# or
npx tempus-mcp

Usage

1. Get your Toggl API Token

Go to https://track.toggl.com/profile and copy your API token.

2. Run the MCP server

export TOGGL_API_TOKEN="your_token_here"
tempus-mcp

3. Configure your MCP client

Claude Desktop:

{
  "mcpServers": {
    "tempus": {
      "command": "tempus-mcp",
      "env": {
        "TOGGL_API_TOKEN": "your_token_here"
      }
    }
  }
}

Opencode / other MCP clients (recommended): If your MCP client does not reliably pass environment variables through npx, pass the token directly via CLI arguments:

{
  "mcpServers": {
    "tempus": {
      "command": ["npx", "-y", "tempus-mcp", "--token", "your_token_here", "--workspace-id", "12345678"]
    }
  }
}

Other MCP clients: The server uses stdio transport, compatible with any MCP client.

Environment Variables

VariableRequiredDescription
TOGGL_API_TOKEN✅Your Toggl Track API token
TOGGL_DEFAULT_WORKSPACE_ID❌Default workspace ID for convenience
TOGGL_BASE_URL❌API base URL (default: https://api.track.toggl.com/api/v9)

Features

  • ✅ Past date time slots — Create time entries for any date in the past
  • ✅ Project assignment — Assign entries to any project
  • ✅ Full CRUD — Create, read, update, delete time entries
  • ✅ Billable tracking — Mark entries as billable
  • ✅ Tag support — Add tags to time entries
  • ✅ Running entries — Start, stop, and query current timer

Development

git clone https://github.com/Kos-M/tempus-mcp.git
cd tempus-mcp
npm install
npm run build
TOGGL_API_TOKEN=your_token npm start

License

MIT

Ver o original no GitHub

Bom para

Relacionados