Use TimeFinder with ChatGPT, Claude and Siri
Ask an assistant what’s on your schedule, have it add a task or find a free slot for one, or see how you spent your time. You choose whether it can only read or can also make changes.
Before you start
You need a TimeFinder account. Create one in the app for iPhone, iPad and Mac, Android or Windows, or in the web app, then come back here. Connecting is free and doesn’t need Premium.
Accounts with end-to-end encryption can’t be connected.
Every assistant uses the same connection address:
https://api.timefinder.app/mcpChatGPT
Add TimeFinder from ChatGPT on the web. Your ChatGPT plan, and in a workspace your administrator, decides whether you can add a custom MCP server.
- Open Plugins in ChatGPT, select + and choose Add custom MCP server.
- Name it TimeFinder, paste the connection address and choose OAuth for authentication.
- Confirm the warning, then select Create as a plugin.
- When ChatGPT opens TimeFinder, sign in, choose what ChatGPT can do and select Allow access.
- In a new chat, type @, pick TimeFinder and ask, for example, “What’s on my schedule tomorrow?”
Claude on the web, desktop and mobile
Add TimeFinder once on claude.ai or in Claude Desktop, and it’s also available in the Claude mobile app. Free plans can add one custom connector. On Team and Enterprise plans, an owner adds it under Organization settings → Connectors, and then each person connects their own account from Customize → Connectors.
- Open Customize → Connectors, select + Add and choose Add custom connector.
- Name it TimeFinder, paste the connection address and select Continue.
- Under OAuth client, choose Register automatically, then select Add.
- Sign in to TimeFinder, choose what Claude can do and select Allow access.
- In a chat, select +, open Connectors and turn on TimeFinder. Then ask, for example, “Which tasks are due this week?”
Claude Code
- In your terminal, run:Add
claude mcp add --transport http timefinder https://api.timefinder.app/mcp--scope userto use TimeFinder in every project instead of only the current one. - Start Claude Code, run
/mcp, select timefinder and choose to authenticate. - Your browser opens TimeFinder. Sign in, choose what Claude Code can do and select Allow access. The page tells you it’s returning to an address on your computer; only allow access if you started the connection yourself.
What an assistant can do
When you connect, TimeFinder lists what’s being requested and lets you choose between two levels of access.
- Read only
- The assistant can see your lists and tasks, including subtasks and notes, and your schedule for any day, including recurring appointments and events from calendars you’ve connected to TimeFinder. It can also summarize time recorded with Focus and finished schedule blocks over up to 92 days.
- Read and make changes
- It can also create, edit, complete, reopen and delete tasks, and put them on your schedule or take them off. It can create, rename and archive lists, and create, move, resize and delete appointments. TimeFinder refuses a new or moved block that would overlap something on your schedule, unless you’ve told the assistant the overlap is fine.
Recurring appointments and events from connected calendars can’t be edited or deleted here. Change those in TimeFinder or in your calendar. Taking a task off a recurring block can still change that block.
Deleted tasks and archived lists go to Recently Deleted in TimeFinder, where you can restore them for 90 days. Deleted appointments, including a block emptied by removing its last task, can’t be restored. ChatGPT, Claude and Claude Code ask you before running an action that changes or deletes something, unless you’ve changed their settings to allow it.
Every action the assistant can use
Read only
- get_lists: your lists
- get_tasks: tasks across every list, with optional filters such as due date or completed
- search_tasks: tasks whose title or notes match some text
- get_schedule: one day’s schedule and busy times
- get_time_summary: time spent by day, list and task for up to 92 days
Read and make changes
- create_task, update_task, complete_task, uncomplete_task, delete_task
- create_list, update_list, archive_list
- schedule_task, unschedule_task
- create_appointment, update_appointment, delete_appointment
Disconnect
In TimeFinder, open Settings → Integrations → AI Connections and select Revoke access under the assistant. It can no longer read or change anything in your account. Claude Code connections are listed under Claude.
You can also remove TimeFinder from the assistant itself:
- ChatGPT: in Settings → Plugins, select TimeFinder and choose Disconnect.
- Claude: in Customize → Connectors, select … next to TimeFinder and choose Remove.
- Claude Code: run
claude mcp remove timefinder.
Revoking in TimeFinder is the one that ends access on our side, so do that too if you want to be sure.
Your data
An assistant only reaches the account you signed in with, and only while your access is in place. ChatGPT and Claude keep what they read under their own privacy policies; revoking access stops further reads and changes but doesn’t remove what the assistant already received. Read TimeFinder’s privacy policy for what we keep about each connection and for how long.
If something goes wrong
- TimeFinder says you need an account. Create your account in the TimeFinder app, then start the connection again from the assistant.
- TimeFinder says your account is encrypted. End-to-end encrypted accounts can’t be connected. If you turned encryption on yourself, you can turn it off in TimeFinder and try again.
- The sign-in page expired. Start the connection again from ChatGPT, Claude or Claude Code.
- The assistant can’t make changes. You chose Read only. Revoke access in TimeFinder, then connect again and choose Read and make changes.
Still stuck? Email [email protected].
Siri and Shortcuts
On iPhone and iPad with iOS 16 or later, TimeFinder adds these actions to Siri and the Shortcuts app. They work without ChatGPT or Claude.
- Save Task adds a task to a list without opening TimeFinder. Try “Save a task in TimeFinder.”
- Complete Task marks a task done. Try “Complete a task in TimeFinder.”
- Today’s Plan reads out what is still scheduled or due today. Try “What’s my plan in TimeFinder?”
- Add Task Draft opens a new task in TimeFinder so you can edit it before saving.
Example: send action items from another app
This shortcut turns a list of action items into tasks. Each line of text becomes its own task.
- In the Shortcuts app, create a new shortcut and turn on Show in Share Sheet, accepting text.
- Add Split Text and set it to split by New Lines.
- Add Repeat with Each. Inside it, add Save Task in TimeFinder, set the task name to Repeat Item and pick a list.
- In another app, select the action items, tap Share and choose your shortcut.
To review each item before saving, use Add Task Draft instead.