Connect ChatGPT to Hourbun
By Fred Wu, maker of Hourbun · Checked · Report a mistake
The short answer
ChatGPT connects to Hourbun as a custom MCP server: on chatgpt.com, add the address https://hourbun.com/api/v1/mcp under Connection, choose OAuth and sign in to Hourbun. No token is needed. Choose the workspace and the access when Hourbun asks, and ChatGPT then tracks time, runs your timer and reads your hours and invoices as you, with your role.
Set it up
The setup that the page API & MCP of Hourbun gives, with the address of the server.
https://hourbun.com/api/v1/mcp
What to ask
Ask in your own words: the assistant chooses the tools of Hourbun. Under each question, the tools that it calls. The tools of invoices and uninvoiced time answer for the owner and the admins.
-
“Track 2 hours on Website for today: design review.”
Calls
list_projectsthencreate_time_entry -
“What is not invoiced this month?”
Calls
whoamithenget_uninvoiced -
“Which of my invoices are overdue?”
Calls
list_invoices -
“How many hours did I track last week, and on which projects?”
Calls
whoamithenlist_time_entries
Where it works#
ChatGPT adds Hourbun on chatgpt.com, as a plugin with a custom MCP server. It signs in to Hourbun with OAuth, so it takes the address of the server alone, and you never copy a token into ChatGPT. The policies of your ChatGPT account and workspace apply to custom MCP servers: an admin of a ChatGPT workspace may have to allow it before you can add it.
In a new conversation, type @ and select Hourbun, so ChatGPT uses its tools. ChatGPT lists the tools that it found when you create the plugin: each tool names the access that it needs, and a connection with Read gets no tool that writes. When ChatGPT calls a tool that writes with such a connection, Hourbun refuses it and names the access that it needs, in the form of OAuth that ChatGPT reads.
Allow the connection#
When ChatGPT opens Hourbun, sign in, and Hourbun asks you to allow it. The page names ChatGPT and where Hourbun sends your answer. Choose the Workspace and the Access: Read, or Read and write to also track time and use your timer. Then press Allow, or Deny.
The connection works in that one workspace, with your role there. Hourbun keeps it as a token of yours, with an access token that lives 1 hour and a refresh token that ends after 90 days without use, both only as secure hashes. The access of a connection never changes: for other access, connect ChatGPT again.
What ChatGPT can do#
Hourbun has one MCP tool for each operation of its API, and ChatGPT gets only the tools that your role and the access allow. With Read, it reads your projects, clients, tasks, time entries, timer and expenses. With Read and write, it also tracks time, changes and deletes your time entries, and starts, pauses, resumes, stops and discards your timer. Invoices and uninvoiced time are for the owner and the admins of the workspace: a member or a manager gets no tool for them.
Each tool calls what the REST API calls, so ChatGPT gets the same answers, amounts and refusals as a script. An entry on an issued invoice, or an approved or submitted one, is locked, and a money field that your role does not see is left out. Hourbun keeps no prompt and no chat: a tool receives only its arguments.
Stop the connection#
Each token and each connection is in the list of the page API & MCP, with its access, its status and the day of its last use. Revoke ends it at once, and Hourbun refuses the next request of ChatGPT. The owner and the admins of the workspace can revoke it too, and it stops when you leave the workspace.
Questions
Questions and answers
Does Hourbun work in ChatGPT?
Yes. ChatGPT connects to Hourbun's MCP server as a custom MCP server, with the address of the server and one sign-in to Hourbun. The MCP server is on every plan of Hourbun, and the policies of your ChatGPT account and workspace apply.
Does ChatGPT need a Hourbun token?
No. ChatGPT signs in to Hourbun with OAuth: you sign in, choose the workspace and the access, and press Allow. Hourbun keeps the connection as a token of yours, which Revoke on the page API & MCP ends.
Can ChatGPT change my invoices in Hourbun?
No. ChatGPT reads invoices and uninvoiced time when your role is admin or owner, and with Read and write it tracks time and uses your timer. No tool creates, sends or changes an invoice.
Sources
The setup of ChatGPT follows its own documents, read on 15 November 2026: