TimeFinder

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/mcp

ChatGPT

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.

  1. Open Plugins in ChatGPT, select + and choose Add custom MCP server.
  2. Name it TimeFinder, paste the connection address and choose OAuth for authentication.
  3. Confirm the warning, then select Create as a plugin.
  4. When ChatGPT opens TimeFinder, sign in, choose what ChatGPT can do and select Allow access.
  5. In a new chat, type @, pick TimeFinder and ask, for example, “What’s on my schedule tomorrow?”

OpenAI’s guide to custom MCP servers

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.

  1. Open Customize → Connectors, select + Add and choose Add custom connector.
  2. Name it TimeFinder, paste the connection address and select Continue.
  3. Under OAuth client, choose Register automatically, then select Add.
  4. Sign in to TimeFinder, choose what Claude can do and select Allow access.
  5. In a chat, select +, open Connectors and turn on TimeFinder. Then ask, for example, “Which tasks are due this week?”

Anthropic’s guide to custom connectors

Claude Code

  1. In your terminal, run:
    claude mcp add --transport http timefinder https://api.timefinder.app/mcp
    Add --scope user to use TimeFinder in every project instead of only the current one.
  2. Start Claude Code, run /mcp, select timefinder and choose to authenticate.
  3. 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.

Claude Code’s guide to MCP servers

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:

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

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.

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.

  1. In the Shortcuts app, create a new shortcut and turn on Show in Share Sheet, accepting text.
  2. Add Split Text and set it to split by New Lines.
  3. Add Repeat with Each. Inside it, add Save Task in TimeFinder, set the task name to Repeat Item and pick a list.
  4. In another app, select the action items, tap Share and choose your shortcut.

To review each item before saving, use Add Task Draft instead.