TimeIQ for AI assistants

Use TimeIQ inside Claude, ChatGPT and Cursor.

Your calendars, meetings, hours and invoices, connected to your AI assistant through MCP. Ask when you're free, log client work or prepare an invoice in the chat you already have open.

Connect TimeIQ Sign up

Works with your connected calendars and TimeIQ account.

Your assistant + TimeIQExample chat

You

When am I free Thursday afternoon?

TimeIQ

You have two open windows on Thursday, in your time zone (America/New_York). These fit your working hours and account for every connected calendar.

1:00–2:30 pm: 90 minutes free
3:30–5:00 pm: 90 minutes free

Your existing events stay on your calendar.

get_profile → get_free_times

Sample data. Choose a prompt to see how the tools work. Your assistant's wording will vary.

Connect your assistant.

Choose your client. Use the hosted server URL below, then connect your TimeIQ account.

Server URL · Streamable HTTP

https://api.timeiq.app/mcp

ClaudeChatGPTClaude CodeCursor & others

Claude on the web or desktop

Open Settings → Connectors (called Customize → Connectors in some versions).
Choose Add custom connector and name it TimeIQ.
Paste https://api.timeiq.app/mcp as the server URL.
Connect, sign in to TimeIQ and select Allow. Enable TimeIQ in the chat's connectors menu.

On a managed workspace, an owner may need to add the connector first. Claude's connector guide

ChatGPT

Open Settings → Connectors (or Apps), then enable developer mode under advanced settings if needed.
Add a custom connector or app named TimeIQ.
Set its MCP server URL to https://api.timeiq.app/mcp.
Connect, sign in to TimeIQ and select Allow. Select TimeIQ in your conversation's tools menu.

Custom connectors depend on your ChatGPT plan and workspace permissions. If the option is missing, check with your workspace owner. OpenAI's connection guide

Claude Code

Run this in a terminal. Complete the browser sign-in when prompted and select Allow. If needed, run /mcp in Claude Code to authenticate TimeIQ.

claude mcp add --transport http timeiq https://api.timeiq.app/mcp

You can also connect with a personal token. In TimeIQ, open Settings → AI assistants, create a token, then replace the placeholder below with it.

claude mcp add --transport http timeiq https://api.timeiq.app/mcp --header "Authorization: Bearer YOUR_TIMEIQ_TOKEN"

Cursor and other MCP clients

Create a personal token in Settings → AI assistants. In Cursor, add this to your MCP configuration (~/.cursor/mcp.json), replacing YOUR_TIMEIQ_TOKEN with the token.

{
  "mcpServers": {
    "timeiq": {
      "url": "https://api.timeiq.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TIMEIQ_TOKEN"
      }
    }
  }
}

For other clients, use the same URL and Authorization header with Streamable HTTP. Keep your token private and outside shared project files. Cursor's MCP guide

Self-hosting? Your endpoint is <your API>/mcp. Replace the hosted server URL in these instructions with yours.

What you can ask TimeIQ to do.

25 tools, using the same account permissions and validation as the TimeIQ app. Your assistant chooses the tools that fit your request.

Availability & bookings

Check your real free time across connected calendars and working hours.

get_profile: Get your name, time zone and public booking link.
get_free_times: Find open windows over the next 5, 7 or 14 days, with a minimum length.
list_event_types: Get your meeting types, durations, locations and booking links.
list_bookings: List your confirmed or cancelled bookings.
cancel_booking: Cancel a booking, email the guest and withdraw the invite after confirmation.

Group meetings

Collect people's availability, then book a time everyone can make.

find_time_with: Create a group meeting with three suggestions from your free time. By default, email people a link to choose times after confirmation.
list_group_meetings: List your group meetings and their current state.
get_group_meeting: See who has answered and rank candidate times by attendance.
book_group_meeting: Book a candidate time and send everyone a calendar invite after confirmation.
remind_group_meeting: Re-send the invite link to people who have not answered, after confirmation.
cancel_group_meeting: Cancel a meeting and notify invited people after confirmation.

Calendars & schedule import

Connect busy times and turn a pasted schedule into calendar events.

list_calendars: List connected calendars and their sync health.
add_calendar: Connect a calendar by its iCal, ICS or webcal link so busy times block bookings.
sync_calendars: Refresh all connected calendars now.
list_calendar_events: Read calendar events in a date range; defaults to the next 7 days.
import_schedule_text: Turn dates and times in pasted text into events that block bookings. Undo the import from Calendars.
get_schedule_email_address: Get your private schedule-import email address and recent imports.

Time & invoices

Record client work and turn logged hours into invoices.

list_clients: List your clients, hourly rates, currencies and billing emails.
log_time: Log hours for a client, with a date and description.
list_time_entries: Read time entries for a date range, optionally for one client.
get_hours_and_money: See this week's hours and target, unbilled amounts, outstanding invoices and this month's payments, per currency.
list_unbilled_time: Get unbilled hours and amounts for each client.
list_invoices: List invoices with their status, totals and due dates.
create_invoice: Create a draft invoice from a client's logged time in a date range.
send_invoice: Email an invoice to the client's billing contacts after confirmation.

You decide what gets sent.

Review shared changesTools that email people or change shared calendars ask you first. TimeIQ instructs your assistant to confirm and marks these tools for client approval. Keep approvals enabled in your client.

Disconnect any timeManage connections and revoke personal tokens in Settings → AI assistants. A revoked token stops working immediately.

Your account stays yoursTokens cannot delete your account or create other tokens. TimeIQ is open source: read the code on GitHub.

A few practical questions.

What is MCP?

The Model Context Protocol is a standard for connecting an AI assistant to an app's tools. TimeIQ's MCP server lets your assistant work with your TimeIQ account from a conversation.

Do I need a TimeIQ account?

Yes. Sign up, connect your calendars and set your working hours in TimeIQ. Your assistant uses that same account. The hosted service follows your TimeIQ subscription; your assistant may have its own plan or workspace requirements for custom connectors.

Can it see other people's calendars?

It reads calendars connected to your account. For a group meeting, it suggests times you are free and asks participants to share their availability through a link. It does not gain access to their private calendars.

Why does my connection fail?

Check that the server URL ends in /mcp and that you have signed in and allowed the connection. For token setup, send Authorization: Bearer followed by your full token. If you revoked or lost it, create a new token in Settings → AI assistants. Check that your TimeIQ subscription is active and your client allows custom connectors.

Can I use a different client or self-host TimeIQ?

Yes. Use an MCP client that supports Streamable HTTP and either browser sign-in or an Authorization header. For a self-hosted installation, replace the hosted URL with your own API's /mcp endpoint. Cloud clients need to be able to reach that URL.

Connect TimeIQ