Hoursmith documentation
Learn how to track time, bill clients, and get paid with Hoursmith — in the web app, from Chrome, or through the REST API, MCP server, and webhooks.
Welcome to the Hoursmith documentation. Hoursmith turns billable time into polished invoices and real payments — with flat-fee pricing, invoices from your own email domain, and payments into your own Stripe account.
Everything in Hoursmith follows one line:
Clients → Projects → Tasks → Time → Invoices → Payment.
If you're brand new, start with the Quickstart. If you're here to automate, jump to the API, MCP server, or Webhooks.
Start here
What is Hoursmith?
The 2-minute overview: who it's for and what it does.
Quickstart
From sign-up to your first paid invoice, step by step.
Core concepts
Workspaces, roles, plans, and how the pieces fit together.
Core workflow
Clients → Projects → Tasks → Time → Invoices → Payment.
By feature
Time tracking
The live timer, manual entries, and the timesheet.
Hoursmith for Chrome
Timers, tasks, quick capture, and workspace search beside any tab.
Invoices
Turn tracked time into invoices and send them.
Payments
Get paid by card via Stripe Connect, or record manual payments.
Payouts
Private Agency compensation, internal bills, external payment records, and team profitability.
Clients & projects
Set up who you bill and what you bill for.
Team & permissions
Roles, invites, and what each person can see.
Reports & dashboard
Where your hours and revenue show up.
For developers
REST API
A typed, versioned API over your whole workspace.
MCP server
Drive Hoursmith from Claude, Cursor, Zed, Odin, and other AI tools.
Webhooks
Get notified when things happen in your workspace.
Need help?
Can't find what you need? Check Troubleshooting, browse the Changelog and Roadmap, or email us at hi@hoursmith.app.