[Integrations](https://hourbun.com/integrations)

# [Connect ChatGPT to Hourbun](https://hourbun.com/integrations/chatgpt)

By Fred Wu, maker of Hourbun · Checked 15 November 2026 · [Report a mistake](mailto:support@hourbun.com)

## 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.

## Where in the app

- API & MCP → Connect an AI assistant

## What you need

- A Hourbun account in an active workspace
- A ChatGPT account that may add a custom MCP server: an admin of a ChatGPT workspace may have to allow it

## Set it up

The setup that the page API & MCP of Hourbun gives, with the address of the server.

### ChatGPT (Sign-in)

On chatgpt.com, open Plugins, select the plus button, then Add custom MCP server. Enter a name, paste this URL under Connection, choose OAuth, and confirm the warning. Select Create as a plugin, then sign in to Hourbun when ChatGPT asks. The policies of your account and workspace apply: an admin of a workspace may have to allow it.

[Docs of ChatGPT](https://developers.openai.com/plugins/deploy/connect-chatgpt)

```
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_projects`, then `create_time_entry`.
- “What is not invoiced this month?” Calls `whoami`, then `get_uninvoiced`.
- “Which of my invoices are overdue?” Calls `list_invoices`.
- “How many hours did I track last week, and on which projects?” Calls `whoami`, then `list_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 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:

- [ChatGPT documentation](https://developers.openai.com/plugins/deploy/connect-chatgpt)

## Related

- [Track time from ChatGPT, Claude and other AI assistants](https://hourbun.com/guides/track-time-with-chatgpt-and-claude)
- [The MCP server in the API reference](https://hourbun.com/developers#mcp)
- [Time tracking in the help centre](https://hourbun.com/help/time-tracking)
- [Claude](https://hourbun.com/integrations/claude)
- [Claude Code](https://hourbun.com/integrations/claude-code)
- [Codex](https://hourbun.com/integrations/codex)
- [Cursor](https://hourbun.com/integrations/cursor)
- [VS Code](https://hourbun.com/integrations/vscode)
- [Gemini CLI](https://hourbun.com/integrations/gemini-cli)
- [All integrations](https://hourbun.com/integrations)
