Skip to content
Hoursmith Docs
MCP

Connect ChatGPT (preview)

Connect one Hoursmith workspace to ChatGPT by signing in. A preview with a reviewed set of 42 tools — no timers, invoice sending, or payments — while the directory listing awaits OpenAI review.

ChatGPT can connect to your Hoursmith workspace through the same sign-in as other AI assistants. It gets a smaller, separately reviewed set of tools than Claude, Cursor, and other MCP clients.

Preview. Hoursmith's listing in the ChatGPT app directory is waiting for OpenAI's review, so you won't find it by searching ChatGPT yet. Until it's published, connect from ChatGPT's developer mode, which depends on your ChatGPT plan and workspace settings. Need help? Email hi@hoursmith.app.

Before you start
Plan
StudioAgency
Role
OwnerAdminManagerMember

A verified Hoursmith account and a workspace on Studio or Agency. There's no separate charge for the ChatGPT connection. Your role still decides what it can see and change.

Connect

Add Hoursmith in ChatGPT

Turn on developer mode in ChatGPT's settings, then add a custom app (connector) with the server URL https://my.hoursmith.app/mcp and OAuth sign-in. You don't create or paste an API token.

Sign in and approve

ChatGPT opens Hoursmith. Sign in (with two-factor authentication if you use it), check the app name and where access goes, choose one workspace, and pick Read only (the default) or Read and write. Select Connect workspace.

Ask about your work

Try "Show my completed time this week" or "Find tasks for Project Atlas." For changes, connect with Read and write and be specific about which project or task you mean.

What ChatGPT can do

The ChatGPT connection has 42 tools, 15 of which make changes:

  • Read your profile and workspace, clients, projects, tasks, time entries, the running timer, expenses, invoices, and teammates — as far as your role allows. Owners and Admins can also read private Payouts where the plan permits.
  • Create and update clients, projects, tasks, completed time entries, and expenses (with Read and write).
  • Delete or archive clients, projects, tasks, time entries, and expenses — only after you confirm that specific action.

It uses get_connection_profile to learn who you are, your workspace, timezone, and date format. The full list is the tools marked ✓ in Available tools, plus get_connection_profile.

What it can't do yet

The ChatGPT connection can't:

  • start, stop, or discard timers — even with Read and write, it offers a link to the app instead
  • create, edit, send, or cancel invoices, or send reminders
  • record payments or refunds, or manage recurring invoices
  • run report tools, manage client contacts, change workspace settings, or manage project members
  • make any Payouts changes, or send email directly

Invoiced time and expenses stay locked, as everywhere else. When a task update adds someone as an assignee, they're notified according to their own notification preferences.

For these workflows, use the app or connect a hosted MCP client.

Read only or Read and write

On the consent screen, Read and write for ChatGPT says it can "also create or update clients, projects, tasks, time entries and expenses within your existing permissions", and that it "cannot directly create or send invoices, send emails, initiate payments, manage billing or access your password or authentication secrets."

To change the access or the workspace, disconnect and connect again. A write request on a read-only connection asks you to reauthorize with write permission.

Results and privacy

Answers include links back to the records in Hoursmith. Invoice results leave out payment-method details such as bank instructions, and Payouts results leave out receiving-method details. Notes and descriptions are returned as written, so they can contain whatever your team typed.

Data returned to ChatGPT is handled under OpenAI's terms and your ChatGPT workspace settings. Disconnecting stops future access but doesn't delete what ChatGPT already received.

Retries

Each write carries a request ID. Repeating the same request returns the original result instead of making the change twice. If Hoursmith can't confirm whether a write finished, it never repeats it on its own — check the workspace before asking again. See Retrying hosted writes.

Disconnect

Go to Account → Security → Connected apps and choose Disconnect. Access ends immediately and your saved work stays. Changing or resetting your password, or using Sign out everywhere, also disconnects ChatGPT; connect again afterwards.

Was this page helpful?

On this page