ChatGPT & AI assistants
Connect Timecade as an MCP connector so an assistant can read your focus data and log sessions.
What the connection can do
Timecade runs a Model Context Protocol (MCP) server. Once connected, ChatGPT can answer questions about your focus time, look up your presets, alarms and world clock, create pomodoro projects and log completed focus sessions — all against your own signed-in Timecade account.
Example prompts: “How many focus minutes did I log last week?”, “Create a Timecade project called Thesis”, “What alarms did I have yesterday?”
Tools exposed to the assistant
list_presetsRead onlyYour saved timer, pomodoro, tabata and alarm presets.
list_pomodoro_projectsRead onlyProjects you track focus time against.
create_pomodoro_projectWrites dataCreates a new project with a name and optional colour.
log_pomodoro_sessionWrites dataRecords a completed focus session against your account.
get_focus_statsRead onlyTotal focus minutes, session count and per-day breakdown (up to 90 days).
list_recent_alarmsRead onlyYour most recent scheduled or fired alarms.
list_world_clockRead onlyThe ordered list of cities and time zones in your world clock.
What ChatGPT can read or change
- Reads only the data of the Timecade account you sign in with during setup.
- Can create pomodoro projects and log focus sessions.
- Cannot see or change any other user’s data — access is enforced per account.
- Cannot delete presets, projects, sessions, alarms or world clock entries.
- Cannot reach your account settings, subscription or payment details.
Current limitations
- The assistant cannot start, pause or stop a timer running in your browser. The tools work on stored data, not on the live screen.
- Sessions are logged after the fact, not streamed live.
- Custom MCP connectors require a ChatGPT plan where connectors are available.
- You need a Timecade account; signed-out use is not supported over MCP.
Step by step
- In ChatGPT, open Settings and enable connectors (developer mode where required).
- Choose “Add custom connector” / “Add MCP server” and paste the Timecade server URL:
https://timecade.com/mcp - Give it a name, for example “Timecade”, and continue.
- You are sent to Timecade to sign in. Use the same account you use in the app, then approve the access request on the consent screen.
- Back in ChatGPT, verify the connection with a prompt like “List my Timecade presets”.
Troubleshooting
- Sign-in loop, no consent screen: sign in to Timecade in the same browser first, then retry adding the connector.
- “No tools found”: the URL must be exactly the one above, with no trailing slash or path.
- Empty results: you likely approved a different Timecade account, or there is no data yet. Remove the connector and reconnect.
- Stopped working after a while: the access token expired — reconnect the connector.
- No “add connector” option: your ChatGPT plan does not expose custom connectors yet.
Other assistants
The same URL works with any MCP-capable client, such as Claude or Cursor. ChatGPT is the path we document and test.
Instructions last updated