Model Context Protocol

Track your hours by just saying so.

TimeWarp is an MCP server. Connect it once and your assistant can book time, start and stop the timer, read your timetable and draft invoices — against your real account, with your permission, in plain language.

Server URLhttps://timewarp.sp33c.tech/mcp

ChatGPT

Plus, Pro, Business or Enterprise — connectors are not available on the free tier.

  1. Open Settings → Apps & Connectors and choose Create (you may need to turn on developer mode first).
  2. Paste https://timewarp.sp33c.tech/mcp as the MCP server URL.
  3. Pick OAuth as the authentication method — leave the client id and secret blank, TimeWarp registers ChatGPT automatically.
  4. Press Connect, sign in to TimeWarp in the window that opens, and approve the request.

Claude

claude.ai on Pro, Max, Team or Enterprise, and Claude Desktop.

  1. Open Settings → Connectors and choose Add custom connector.
  2. Paste https://timewarp.sp33c.tech/mcp and press Add.
  3. Press Connect, sign in to TimeWarp, and approve the request.

Claude Code, editors, anything else

Any client that speaks Streamable HTTP with OAuth 2.1.

claude mcp add --transport http timewarp https://timewarp.sp33c.tech/mcp

What it can do

Forty-odd tools over the whole TimeWarp API — everything the app can do, bar deleting your account. A few of them:

Book time

Log work that already happened, or run the timer live — breaks included.

  • book_time
  • start_timer / stop_timer
  • pause_timer / resume_timer
  • spread_time

Focuses & customers

Create, rename, re-tag and archive what you track against.

  • list_focuses
  • create_focus / update_focus
  • list_customers
  • create_customer

Report

Hours per focus, per customer, per day — and the export.

  • get_timetable
  • get_bill
  • export_timetable
  • list_time_entries

Invoice

Draft from unbilled time, issue, share, mark paid.

  • create_invoice
  • finalize_invoice
  • share_invoice
  • mark_invoice_paid

Remind & export

Get nudged to log a focus, and take the timetable out as a real file.

  • set_focus_reminder
  • get_reminders
  • export_timetable
  • link_google_sheet

Try saying

  1. “Book three hours on the Acme redesign yesterday afternoon, note: wireframes.”
  2. “Start the timer on client calls.”
  3. “How many hours did I put into Acme last month, by week?”
  4. “Draft an invoice to Acme for August and show me the lines before issuing it.”

What the assistant sees. While it is connected it can read your focuses, your notes, your booked hours, your customers and your invoices, and it can act as you — and everything it reads is sent to whoever makes that assistant, who processes it under their own privacy policy, not ours. So connect one you are willing to show your clients' data to.

The connection is scoped to your account and nothing else. It never carries your password, and it cannot change your plan or delete your account. End it whenever you like under Settings → Connected apps or by removing the connector — access dies within the hour. Full detail in our Privacy Policy. Customers, billable totals and invoicing need TimeWarp Pro; booking time and the timetable do not.