Claude Code Integration

Claude Code ist der Coding-Agent von Anthropic für das Terminal. Mit installiertem Timesheet-Plugin startet und stoppt er Timer, hält gerade erledigte Arbeit fest und beantwortet Fragen dazu, wohin Ihre Stunden geflossen sind, ohne dass Sie das Fenster wechseln.

Was Sie fragen können

• „Starte den Timer für das API-Projekt“
• „Stoppe den Timer und füge eine Notiz hinzu: Login-Bug behoben“
• „Woran habe ich gestern gearbeitet?“
• „Buche 2 Stunden auf das Mobile-App-Projekt für Montag“
• „Exportiere den letzten Monat als Excel und schicke ihn an meine Buchhaltung“

Voraussetzungen

• Ein Timesheet Pro-Tarif oder höher. Siehe Tarife und Preise.
• Ein Timesheet API-Schlüssel, erstellt in der Web-App unter Integrationen > API-Schlüssel.
• Node.js 18 oder höher.

Plugin installieren

Führen Sie diese beiden Befehle in einer Claude-Code-Sitzung aus:

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

Das Plugin bringt einen Skill mit, der jede Befehlsgruppe von @timesheet/cli dokumentiert. Claude Code kennt damit die genauen Flags und Abläufe, statt zu raten.

Installieren Sie anschließend die CLI, die das Plugin steuert, und melden Sie sich einmalig an:

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login nutzt OAuth 2.1 mit PKCE und öffnet den Browser. Für Automatisierung und CI setzen Sie stattdessen einen API-Schlüssel:

export TIMESHEET_API_KEY=ts_your.apikey
timesheet auth status --json

Oder per MCP verbinden

Wenn Claude Code lieber typisierte Tools aufrufen soll statt Shell-Befehle, tragen Sie den Timesheet MCP-Server in ~/.claude/settings.json ein:

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Beide Wege führen zum selben Konto. Das Plugin passt zu Shell-Workflows und skriptbarer Ausgabe, der MCP-Server zu Assistenten, die strukturierte Tool-Aufrufe bevorzugen.

Skill ohne Plugin nutzen

Die CLI liefert dieselbe Skill-Datei mit, sodass jeder Agent sie laden kann, der Skills unterstützt:

timesheet skill path      # zuerst prüfen, wohin geschrieben würde
timesheet skill install   # in das Skills-Verzeichnis des Agenten schreiben

Gut zu wissen

• Jeder Lesebefehl akzeptiert --json, die Ausgabe bleibt also maschinenlesbar. Beim Weiterleiten an einen anderen Befehl wird automatisch auf TSV umgestellt.
• Exit-Code 3 bedeutet, dass sich die Sitzung neu anmelden muss.
• Ihr API-Schlüssel gewährt vollen Zugriff auf Ihr Konto. Checken Sie ihn niemals in die Versionsverwaltung ein. Zum Entziehen löschen Sie den Schlüssel unter Integrationen > API-Schlüssel.