Tyme MCP Server Setup

Note: This guide is for the Tyme Mac app. You need Tyme 2026.9 or later — earlier versions don't include the MCP server.

With Tyme's local MCP server (Model Context Protocol) you can use the AI assistant of your choice — such as Claude or ChatGPT — to read and process your Tyme data. You can ask questions like:

• How was my team's utilization last month?
• Are there missing time entries according to my work schedule?
• Are my projects on track in terms of time and budget?

Your AI assistant will pull the data from Tyme via the MCP server and calculate the answers for you. You can also use it to add many time entries at once, or log an entire vacation retroactively. The possibilities are endless.

The MCP server is only available locally for now; there's no remote/HTTP endpoint yet, so the assistant you connect it to must run on the same Mac as Tyme.

For setup you need two things, both shown here: "Tyme → Settings → AI & MCP"

• The path to the MCP server
• Your personal token (TYME_MCP_TOKEN)

1. Enable the "Activate MCP Server" checkbox
2. Have both values ready to copy
3. Then follow the instructions below for your AI assistant

Claude Code

Open Terminal on your Mac and run:

claude mcp add tyme -e TYME_MCP_TOKEN=<YOUR_TOKEN> -- <PATH_TO_TYME_MCP>

Replace <YOUR_TOKEN> and <PATH_TO_TYME_MCP> with the values from Tyme. Claude Code will confirm that the tyme server was added — you can verify anytime with claude mcp list.

Claude Desktop

1. Open Claude Desktop and go to Settings → Developer → Edit Config. Then open the file claude_desktop_config.json in a text editor.
2. Add a tyme entry to mcpServers, or create the mcpServers entry if it doesn't exist yet. Add the path and token from Tyme (Tyme → Settings → AI & MCP).
3. claude_desktop_config.json will then look something like this:

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

3. Save the file
4. Restart Claude Desktop
5. The Tyme MCP server is now ready

ChatGPT Desktop

1. Open ChatGPT Desktop and go to Settings → Plugins → MCP → Add
2. Enter tyme as the Name
3. Enter the path to tyme-mcp as the Launch Command (Tyme → Settings → AI & MCP)
4. Add an Environment Variable named TYME_MCP_TOKEN and enter the token from Tyme (Tyme → Settings → AI & MCP)
5. Save the settings
6. Restart ChatGPT Desktop
7. The Tyme MCP server is now ready

Other MCP-Compatible Clients

Many other AI tools can connect to the Tyme MCP server too — for example Cursor, Windsurf, Cline, VS Code with GitHub Copilot, Zed, and JetBrains AI Assistant. They all use the same basic setup: a command (the path to tyme-mcp) and an environment variable (TYME_MCP_TOKEN) with the token from Tyme. Check your client's own MCP documentation for exactly where to enter these.

Troubleshooting

• If the assistant can't reach Tyme, make sure Tyme is running and that the path you entered matches exactly what's shown in the app.
• Ask your AI assistant if the tyme-mcp is configured correctly and can be found.
• If your token ever changes, update it in all connected assistants — old tokens stop working immediately.