Integrations
Hourbun integrations
Hourbun connects to the tools around your work: an import from Harvest or any app, copies of your invoices in Xero, payments into your own Stripe account, AI assistants through its MCP server, and an API with webhooks for your own scripts. Each card leads to the page with its steps.
By Fred Wu, maker of Hourbun · Report a mistake
Move your data
Bring your history from Harvest or any app that exports CSV, with a preview before anything is added, and take all of it out again at any time.
-
Guide
Harvest import
Import a Harvest account into Hourbun with a Personal Access Token: the team, clients, projects, time, expenses, invoices and estimates, after a preview.
Read the guide -
Guide
CSV import from any app
Import a CSV export of any time tracker into Hourbun: map the columns, match the people, preview, then import. A format guide helps an AI agent convert it.
Read the guide -
16 guides
Toggl, Clockify and 14 more apps
A guide for each app whose own help pages give a CSV export of its time entries: its export steps, what maps by itself, and what does not come over.
See the guides -
Help centre
Workspace export
Download a whole Hourbun workspace as one .zip file of CSV files, with receipts and logos, from Settings, Export, also while it is paused.
Read the help page
Accounting and payments
Copy each invoice that you issue to Xero, and let clients pay online into your own Stripe account.
-
Guide
Xero
Connect one Xero organisation to Hourbun: each invoice that you issue is copied to Xero, with its credit notes and, if you choose, its payments.
Read the guide -
Help centre
Stripe online payments
Connect your own Stripe account to Hourbun, and clients pay an invoice by card or bank debit from its page. The money goes to you, and Hourbun records it.
Read the help page
AI assistants
Track time and ask about your hours and invoices from a chat, a terminal or an editor, through Hourbun's MCP server. An assistant works as you, with your role.
-
Sign-in
ChatGPT
Add Hourbun to ChatGPT as a custom MCP server with its address and one sign-in, then track time and ask what is not invoiced, in a chat.
Set it up -
Sign-in or token
Claude
Add Hourbun to Claude as a custom connector with its address and a sign-in, or to Claude Desktop with a token, then track time and ask about your hours.
Set it up -
Token or sign-in
Claude Code
Add Hourbun's MCP server to Claude Code with one command and a token, or sign in with OAuth, then log hours and use your timer from the terminal.
Set it up -
Token
Codex
Add Hourbun's MCP server to Codex with a token in an environment variable and one command, then log hours and check your time from the terminal.
Set it up -
Token or sign-in
Cursor
Add Hourbun's MCP server to Cursor in mcp.json, with a token or a sign-in, then log the hours of your work and use your timer from the editor.
Set it up -
Token or sign-in
VS Code
Add Hourbun's MCP server to VS Code in .vscode/mcp.json, with a token or a sign-in, and track time from GitHub Copilot without leaving the editor.
Set it up -
Token
Gemini CLI
Add Hourbun's MCP server to Gemini CLI with one command and a token, in your project, then track time and check uninvoiced work from the terminal.
Set it up -
Guide
Any AI assistant
Connect Hourbun's MCP server to ChatGPT or Claude with its address and one sign-in, then track time and ask about your hours and invoices in a chat.
Read the guide
Every other assistant
The setup that the page API & MCP of Hourbun gives for each one: an assistant that signs in needs the address alone, and another one takes a token in the place of YOUR_TOKEN.
Chat
-
Perplexity Sign-in
Open Settings, Connectors, choose Custom connector, then Remote. Paste this URL, choose OAuth, and sign in to Hourbun when Perplexity asks. It needs a Pro, Max or Enterprise plan.
https://hourbun.com/api/v1/mcp
-
Mistral Le Chat Sign-in
Open Intelligence, Connectors, choose Add connector, then Custom MCP Connector. Paste this URL and sign in to Hourbun when Le Chat asks. An admin of the Mistral workspace adds it. Docs of Mistral Le Chat
https://hourbun.com/api/v1/mcp
Desktop
-
Raycast Sign-in
Run Install Server (Manage MCP Servers), choose the HTTP transport, paste this URL, keep the OAuth type Dynamic, and sign in to Hourbun when Raycast asks. Docs of Raycast
https://hourbun.com/api/v1/mcp
-
Warp Token
Add it in Settings, Agents, MCP servers: Add, Streamable HTTP or SSE Server (URL). Docs of Warp
{ "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } -
LM Studio Token
Put it in mcp.json (Program, Install, Edit mcp.json). Docs of LM Studio
{ "mcpServers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }
Terminal
-
GitHub Copilot CLI Token
Run it in a terminal. Docs of GitHub Copilot CLI
copilot mcp add --transport http --header "Authorization: Bearer YOUR_TOKEN" hourbun https://hourbun.com/api/v1/mcp
-
OpenCode Token
Put it in opencode.json of a project, or in ~/.config/opencode/opencode.json. Docs of OpenCode
{ "$schema": "https://opencode.ai/config.json", "mcp": { "hourbun": { "type": "remote", "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "oauth": false } } } -
Amp Token
Put it in ~/.config/amp/settings.json. Docs of Amp
{ "amp.mcpServers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Factory Droid Token
Run it in a terminal. Docs of Factory Droid
droid mcp add hourbun https://hourbun.com/api/v1/mcp --type http --header "Authorization: Bearer YOUR_TOKEN" --no-oauth
-
Qwen Code Token
Run it in a terminal. Docs of Qwen Code
qwen mcp add --transport http hourbun https://hourbun.com/api/v1/mcp --header "Authorization: Bearer YOUR_TOKEN"
-
Goose Token
Put it in ~/.config/goose/config.yaml, or add a Remote Extension (Streamable HTTP) with goose configure. Docs of Goose
extensions: hourbun: name: hourbun type: streamable_http uri: https://hourbun.com/api/v1/mcp headers: Authorization: Bearer YOUR_TOKEN enabled: true timeout: 300 -
Grok Build Token
Run it in a terminal. Docs of Grok Build
grok mcp add --transport http hourbun https://hourbun.com/api/v1/mcp --header "Authorization: Bearer YOUR_TOKEN"
-
Auggie Token
Run it in a terminal. Docs of Auggie
auggie mcp add hourbun --transport http --url https://hourbun.com/api/v1/mcp --header "Authorization:Bearer YOUR_TOKEN"
-
Pi Token
Run it in a terminal, and keep the export line in your shell profile: Pi reads the token from HOURBUN_TOKEN. Docs of Pi
export HOURBUN_TOKEN="YOUR_TOKEN" pi mcp add hourbun --url https://hourbun.com/api/v1/mcp --bearer-token-env-var HOURBUN_TOKEN
Editor
-
Antigravity Token
Put it in ~/.gemini/config/mcp_config.json (MCP Servers, Manage MCP Servers, View raw config). Docs of Antigravity
{ "mcpServers": { "hourbun": { "serverUrl": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Cline Token
Put it in cline_mcp_settings.json (MCP Servers, Configure MCP Servers). Docs of Cline
{ "mcpServers": { "hourbun": { "type": "streamableHttp", "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "disabled": false } } } -
Kiro Token
Put it in ~/.kiro/settings/mcp.json, for the Kiro IDE and the Kiro CLI. Docs of Kiro
{ "mcpServers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
TRAE Token
Put it in .trae/mcp.json of a project, or add it in Settings, MCP, Add Manually. Docs of TRAE
{ "mcpServers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Zed Token
Put it in the settings.json of Zed, or add it in Settings, AI, MCP Servers. Docs of Zed
{ "context_servers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Roo Code Token
Put it in .roo/mcp.json of a project, or in the global mcp_settings.json. Docs of Roo Code
{ "mcpServers": { "hourbun": { "type": "streamable-http", "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Kilo Code Token
Put it in kilo.jsonc of a project, or in ~/.config/kilo/kilo.jsonc. Docs of Kilo Code
{ "mcp": { "hourbun": { "type": "remote", "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "oauth": false, "enabled": true } } } -
Junie Token
Put it in ~/.junie/mcp/mcp.json, for Junie in JetBrains IDEs and in the terminal. Docs of Junie
{ "mcpServers": { "hourbun": { "url": "https://hourbun.com/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } -
Continue Token
Put it in ~/.continue/config.yaml.
mcpServers: - name: hourbun type: streamable-http url: https://hourbun.com/api/v1/mcp requestOptions: headers: Authorization: Bearer YOUR_TOKEN
Other
-
Microsoft Copilot Studio Sign-in
In your agent, open Tools, Add a tool, New tool, then Model Context Protocol. Paste this URL as the server URL, choose OAuth 2.0 with Dynamic discovery, then create the connection and sign in to Hourbun. Docs of Microsoft Copilot Studio
https://hourbun.com/api/v1/mcp
-
Any MCP client Token
An assistant that connects to a remote MCP server over HTTP takes these two values. One that signs in with OAuth needs the URL alone.
URL https://hourbun.com/api/v1/mcp Header Authorization: Bearer YOUR_TOKEN
Build your own
A REST API with personal tokens, signed webhooks and an MCP server, for your own scripts and agents.
-
API reference
REST API
Read and change your workspace from a script with a personal token: clients, projects, tasks, time, the timer, expenses, invoices and uninvoiced time.
Read the reference -
API reference
Webhooks
Hourbun posts each event that you choose to an https URL, as JSON signed with the secret of the webhook. The owner and the admins add them in Settings.
Read the reference -
API reference
MCP server
One tool for each operation of the API, for any assistant that connects to a remote MCP server over HTTP: with a sign-in to Hourbun, or with a token.
Read the reference
Every endpoint, event and MCP tool: the API reference. What each feature does: the help centre. How your data is kept: security.