Feature
Connect your AI assistant to Hoursmith.
Add https://my.hoursmith.app/mcp to Claude, Cursor, VS Code, or any MCP client that supports sign-in, approve one workspace with read-only or read/write access, and your assistant gets typed tools for clients, projects, tasks, timers and time entries, expenses, invoices and payments, recurring invoices, reports, and — on Agency — record-only payouts. Ask "log 90 minutes to Coffee Coders" and it happens. Prefer a local setup? Run the open-source @hoursmith/mcp-server package from npm with an API token. Studio and Agency; your role and plan still decide what every tool can do.
Plans: Studio · Agency
14-day Studio or Agency trial · No credit card required
What's in it
Sign in instead of pasting a token
The hosted server at https://my.hoursmith.app/mcp uses standard MCP sign-in: your client opens Hoursmith, you log in (with two-factor authentication if you use it), choose one Studio or Agency workspace, and approve read-only or read/write access. There is no API token to create or store, and Account → Security → Connected apps lists and revokes every connection.
Works with Claude, Cursor, VS Code, and more
Any client that follows the MCP authorization standard can connect without setup on our side — Claude custom connectors, Claude Code, Cursor, VS Code, and others. ChatGPT connects through a separately reviewed preview with a smaller tool set.
Your whole workflow as typed tools
Hosted connections get the full catalog: find and update clients, contacts, projects, and tasks; start, stop, or discard timers and edit time; preview, draft, and send invoices; record manual payments; run recurring invoice series; read time, revenue, receivables, profitability, and cash-flow reports; and, on Agency, prepare and record team payouts. List tools take search, filter, and sort parameters, so 'unpaid invoices for Acme, newest first' is one call.
Role-aware out of the box
Every call runs as the person who connected. Owners and Admins see the whole workspace; Members see only their assigned projects and never invoices, expenses, or rates; Payouts and Cash flow stay with Owners and Admins. Role, plan, and project-access changes apply on the next call.
Confirmation before anything risky
Deleting or archiving, cancelling or voiding, money records, invoice and reminder emails, and anything that turns on automatic client email require your explicit confirmation. Emails go only to addresses already on file for the client, payment tools only record payments made elsewhere, and hosted writes carry a request ID so a retried call never applies twice. If a result can't be confirmed, check the workspace before trying again.
Errors round-trip with detail
Validation failures, plan-gate denials (with `requiredPlan`), and conflict errors (invoiced-time-entry-locked, etc.) all surface back to the LLM as actionable text, not opaque "something went wrong".
Open source on npm for local setups
npx -y @hoursmith/mcp-server runs the MIT-licensed server over stdio for Claude Desktop, Cursor, or Zed, or as a local Streamable HTTP endpoint for URL-only clients like Odin, authenticated with a Hoursmith API token. The published npm package covers clients, projects, tasks, time entries, expenses, invoice and member lookups, and read-only Payouts; timers, invoice drafts and sending, payments, recurring invoices, and reports are on the hosted connection.
How it works
- 01
1. Add the server URL
In Claude, add a custom connector; in Cursor, VS Code, Claude Code, or another client, add an HTTP MCP server. Use https://my.hoursmith.app/mcp as the URL.
- 02
2. Sign in and approve
Your client opens Hoursmith's sign-in. Check the app name and callback site, choose one Studio or Agency workspace, and pick read-only or read/write access.
- 03
3. Ask in plain English
Ask "what am I tracking right now?" or "draft an invoice for Acme's unbilled time this month and show me the preview". The assistant picks the right tool and asks before anything risky.
- 04
4. Revoke or reconnect anytime
Account → Security → Connected apps shows each connection's workspace and permissions; revoking stops it immediately. Changing your password or using Sign out everywhere disconnects every app. Reconnect to switch workspaces or change access.
Common questions
Do I need to run or host anything?
No. The hosted connection runs at https://my.hoursmith.app/mcp; you add the URL to your MCP client and sign in. The npm package is an optional local alternative: it runs as a child process of your LLM client (Claude Desktop, Cursor, Zed) or as a local HTTP endpoint, usually at http://localhost:8000/mcp/, authenticated with an API token. Nothing needs to be deployed publicly.
Where are my credentials stored?
With the hosted connection you never create or paste an API token: your client holds short-lived access credentials issued after you sign in, and revoking the connection in Account → Security → Connected apps stops them. With the local npm package, your API token lives only in your LLM client's config file or the HTTP client's per-request headers; the server reads it, sends it as a Bearer header to Hoursmith, and never writes it anywhere.
Can a Member's connection do everything an Owner can?
No. Every tool runs with the connecting person's current role. A Member sees only the projects they've been added to and can only change their own time entries — identical to what the app shows them. Invoices, expenses, rates, Payouts, and Cash flow stay out of reach. We don't run shadow permissions.
Can my assistant send invoices or move money?
It can send an invoice or a reminder only to email addresses already on file for that client, and only after you confirm. Payment tools record payments made elsewhere — nothing transfers money, charges a card, or pays a team member.
Does ChatGPT get the same tools?
Not yet. ChatGPT connects through a separately reviewed preview with a smaller tool set: it can find and update everyday records and log completed time, but it can't start timers or create or send invoices. See the ChatGPT connection page for details.
Will I get charged anything to use this?
MCP access is included on Studio and Agency plans, with the API's per-token rate limits (see the API page). There's no separate charge, and the npm package is open source and free.
Related
Try it free, in two minutes.
Create an account, set up your first client, and log an hour. The invoice will already be on the way to building itself.
14-day Studio or Agency trial · No credit card · Cancel any time