Connect by signing in
Add https://my.hoursmith.app/mcp to Claude, Claude Code, Cursor, VS Code, or any MCP client, sign in to Hoursmith, and choose one workspace and Read only or Read and write access. No API token needed.
The hosted Hoursmith MCP server lets an AI assistant work in your workspace without an API token or anything to install. You add one URL to your MCP client, sign in to Hoursmith in your browser, and approve what the connection may do.
https://my.hoursmith.app/mcpThe hosted connection gets the full tool catalog — 124 tools, including timers, invoice drafts and sending, manual payments, recurring invoices, reports, and Payouts. See Available tools.
- Plan
- StudioAgency
- Role
- OwnerAdminManagerMember
A verified Hoursmith account and a workspace on Studio or Agency. Any role can connect; the connection can only do what your role allows. Your MCP client must support remote (Streamable HTTP) servers with sign-in, which current versions of Claude, Claude Code, Cursor, and VS Code do.
Using ChatGPT? It connects to the same address but gets a smaller, separately reviewed set of tools. See Connect ChatGPT.
Add the server to your client
Menu names change between client versions; the address and the sign-in step stay the same.
Works in Claude on the web and in the Claude desktop app.
- Open Settings → Connectors and choose Add custom connector. On a Team or Enterprise plan, an owner may need to add the connector for the organization first.
- Name it
Hoursmithand enterhttps://my.hoursmith.app/mcpas the server URL. Leave any optional OAuth client ID and secret fields empty. - Select Add, then Connect. A Hoursmith tab opens — finish the steps in Approve the connection.
- In a chat, turn on the Hoursmith tools from the tools menu.
Add the server from your terminal:
claude mcp add --transport http hoursmith https://my.hoursmith.app/mcpAdd --scope user to make it available in every project. Then, inside Claude Code, run /mcp, pick
hoursmith, and choose to authenticate. Your browser opens the Hoursmith sign-in — continue with
Approve the connection.
Add the server to ~/.cursor/mcp.json (or a project's .cursor/mcp.json):
{
"mcpServers": {
"hoursmith": {
"url": "https://my.hoursmith.app/mcp"
}
}
}Open Cursor's MCP settings, find hoursmith, and use its sign-in (connect) button. Complete Approve the connection in the browser; Cursor picks the connection up when you return.
Run MCP: Add Server from the Command Palette, choose HTTP, enter
https://my.hoursmith.app/mcp, and name it hoursmith. Or add it to .vscode/mcp.json:
{
"servers": {
"hoursmith": {
"type": "http",
"url": "https://my.hoursmith.app/mcp"
}
}
}When VS Code asks whether the server may sign in to my.hoursmith.app, allow it and complete
Approve the connection. The tools then appear in the chat's tool picker in
agent mode.
Any client that follows the MCP authorization standard can connect without setup on Hoursmith's side:
- Transport: Streamable HTTP (sometimes labelled "HTTP" or "remote").
- URL:
https://my.hoursmith.app/mcp - Authentication: OAuth sign-in. No API key, header, or client ID — the client discovers the sign-in from the server and registers itself. Leave optional client ID and secret fields empty.
If your client only supports API keys or custom headers, use the local npm package with an API token instead.
Some clients limit how many tools can be active at once. If yours warns about the number of tools, turn off the tool groups you don't need in the client's tool picker.
Approve the connection
Your client opens Hoursmith in the browser.
Sign in
Sign in as usual, including two-factor authentication if you use it. To connect a different account, choose Use a different account.
Check who is asking
The page names the app and shows where access goes, for example "Approving sends this connection's access to https://claude.ai", or "to an app on this device" for desktop and command-line clients. If Hoursmith shows a warning that the address isn't the site that published the app's details, connect only if you expected that address.
Choose one workspace
Pick the workspace under Workspace. Workspaces that aren't on Studio or Agency are shown but can't be chosen ("Studio or Agency required").
Choose the access
Under Access permissions, pick Read only (the default) or Read and write. Read and write lists every kind of change the connection could make — see below.
Connect
Select Connect workspace. You return to your client, and the Hoursmith tools are ready. Try "Show me my Hoursmith profile."
Read only or Read and write
Read only lets the assistant read the clients, projects, tasks, time, expenses, and invoices your role can see. Owners and Admins can also read private Payouts where the plan permits.
Read and write also lets it make changes, within your role and project access. The consent screen lists each kind of change:
- create, update, archive, and delete clients, projects, tasks, time entries, and expenses, including bulk time changes
- start, stop, and discard your running timer
- post, edit, and delete task comments, and mark your notifications read
- create, edit, duplicate, correct, cancel, and delete invoices, and manage recurring invoices
- email your clients: invoices, reminders, and receipts, now or on a schedule
- record and refund manual payments
- manage team payouts (Owners and Admins on Agency)
- change workspace settings
- add and remove project members
- add, change, and remove client contacts, including portal access
No connection can charge cards, transfer money, manage your Hoursmith subscription, or see your password or authentication secrets. Payment and payout tools only record money that moved outside Hoursmith.
Read and write appears only when write access is available for connected apps. If the consent screen offers only Read only, the connection can read but not change anything. A write tool on a read-only connection answers "This tool needs write permission. Reauthorize Hoursmith with that permission." To change the access, disconnect and connect again.
Even with Read and write, risky actions — deleting, sending email, recording money, and anything that turns on automatic client email — need your explicit confirmation of that specific action. See Confirmations.
One workspace per connection
Each connection is tied to the workspace you chose. Switching workspaces in the Hoursmith app doesn't move it. To use another workspace, connect again and choose it — each connection appears separately in Connected apps. You can have up to 10 active connections per workspace; past that, disconnect one you no longer use first.
Retries and uncertain results
Every hosted write carries a requestId that your assistant creates. Repeating the same request ID
with the same arguments returns the original result instead of making the change twice. If Hoursmith
can't confirm whether a write finished, it says so and never repeats it on its own — check the
workspace before trying again. Details: Retrying hosted writes.
Limits
The hosted connection shares the API's per-connection budgets: 30 calls per 10 seconds and 600 per minute on Studio, 60 per 10 seconds and 1,200 per minute on Agency, with at most 180 writes a minute. Each connection runs two requests at a time; extra requests wait briefly, then get a "too many requests" answer with a wait time. A single request can be up to 256 KB.
Staying connected
Your client renews its access in the background. A connection ends when:
- you disconnect it, or remove the app in your client
- you change or reset your password, or use Sign out everywhere — this disconnects every app
- it goes unused for 30 days
- you're removed from the workspace, or the workspace is closed
If the workspace moves to the Free plan, calls fail with "Connected apps require Studio or Agency." until it's back on a paid plan. To reconnect, run the sign-in from your client again.
Disconnect an app
Go to Account → Security → Connected apps (my.hoursmith.app/account/security). Each connection shows its app, workspace, access, and where its access goes. Choose Disconnect — access ends immediately, and your saved work stays. Data the app already received isn't recalled.
Requirements
What you need to connect an AI assistant to Hoursmith — a Studio or Agency workspace, plus either a client that supports sign-in, ChatGPT developer mode, or Node.js and an API token.
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.