Tyme MCP-Server einrichten

Hinweis: Diese Anleitung gilt für die Tyme Mac-App. Du benötigst Tyme 2026.9 oder neuer – frühere Versionen enthalten den MCP-Server nicht.

Mit dem lokalen Tyme MCP-Server (Model Context Protocol) kannst du mit dem KI-Assistenten deiner Wahl, z.B. Claude oder ChatGPT deine Tyme-Daten auslesen und weiterverarbeiten. Du kannst nun Anfragen stellen wie z.B.:

• Wie war die Auslastung meines Teams letzten Monat?
• Fehlen laut meinem Arbeitsplan Zeiteinträge?
• Liegen meine Projekte gut in Zeit und Budget?

Dein KI-Assistent zieht sich per MCP-Server dann die Daten aus Tyme und errechnet dir die Antworten. Du kannst so z.B. auch viele Zeiteinträge oder einen ganzen Urlaub nachtragen. Der Fantasie sind keine Grenzen gesetzt.

Der MCP-Server ist aktuell nur lokal verfügbar; es gibt noch keinen Remote-/HTTP-Endpunkt. Der KI-Assistent, den du verbindest, muss also auf demselben Mac laufen wie Tyme.

Für die Einrichtung benötigst du zwei Infos, die hier anzeigt werden: "Tyme -> Einstellungen → AI & MCP"

• Den Pfad zum MCP-Server
• Deinen persönlichen Token (TYME_MCP_TOKEN)

1. Aktiviere die Checkbox "Aktiviere MCP Server"
2. Halte beide o.g. Werte zum Kopieren bereit
3. Folge nun den folgenden Anweisungen für den jeweiligen KI-Assistenten

Claude Code

Öffne Terminal auf deinem Mac und führe aus:

claude mcp add tyme -e TYME_MCP_TOKEN=<DEIN_TOKEN> -- <PFAD_ZU_TYME_MCP>

Ersetze <DEIN_TOKEN> und <PFAD_ZU_TYME_MCP> durch die o.g. Werte aus Tyme. Claude Code bestätigt, dass der Server tyme hinzugefügt wurde – du kannst dies jederzeit mit dem Befehl claude mcp list überprüfen.

Claude Desktop

1. Öffne Claude Desktop und gehe zu Settings → Developer → Edit Config. Öffne dann die Datei claude_desktop_config.json in einem Texteditor.
2. Füge einen tyme-Eintrag zu mcpServers hinzu oder erstelle den Eintrag mcpServers falls dieser noch nicht existiert. Füge den o.g. Pfad und Token aus Tyme hinzu (Tyme -> Einstellungen -> AI & MCP).
3. Die claude_desktop_config.json sieht dann in etwa wie folgt aus:

{
  "mcpServers": {
    "tyme": {
      "command": "<PFAD_ZU_TYME_MCP>",
      "env": {
        "TYME_MCP_TOKEN": "<DEIN_TOKEN>"
      }
    }
  },
  "coworkUserFilesPath": "/Users/xyz/Claude",
  "preferences": {
    …
  }
}

3. Speichere die Datei
4. Starte Claude Desktop neu
5. Der Tyme MCP-Server ist nun bereit

ChatGPT Desktop

1. Öffne ChatGPT Desktop und gehe zu Settings → Plugins → MCP → Add
2. Trage als Namen tyme ein
3. Trage als Launch Command den o.g. Pfad zu tyme-mcp ein (Tyme -> Einstellungen -> AI & MCP)
4. Füge eine Environment Variable namens TYME_MCP_TOKEN hinzu und trage den o.g. Token aus Tyme ein (Tyme -> Einstellungen -> AI & MCP)
5. Speichere die Einstellungen
6. Starte ChatGPT Desktop neu
7. Der Tyme MCP-Server ist nun bereit

Andere MCP-kompatible Clients

Auch viele andere KI-Tools können sich mit dem Tyme MCP-Server verbinden – zum Beispiel Cursor, Windsurf, Cline, VS Code mit GitHub Copilot, Zed und der JetBrains AI Assistant. Sie alle nutzen dasselbe Grundprinzip: einen Befehl (den Pfad zu tyme-mcp) und eine Umgebungsvariable (TYME_MCP_TOKEN) mit dem Token aus Tyme. In der MCP-Dokumentation deines jeweiligen Clients findest du, wo du diese Werte einträgst.

Fehlerbehebung

• Wenn der Assistent nicht auf Tyme zugreifen kann, stelle sicher, dass Tyme läuft und der eingetragene Pfad exakt dem in der App angezeigten entspricht.
• Frag deinen AI-Assisenten, ob der tyme-mcp korrekt konfiguriert ist und gefunden werden kann.
• Wenn sich dein Token ändert, aktualisiere ihn in allen verbundenen Assistenten – alte Token funktionieren sofort nicht mehr.