MCP App Store
by KeenEthics
Hoursmith icon

Hoursmith MCP Server for Claude and ChatGPT

By Hoursmith

Overview

Connect your existing Hoursmith account to a workspace. Find clients and projects, manage tasks and expenses, log completed time, and read invoices. Choose read-only or read/write access; tools follow your current role and project permissions. Invoice and payout tools are read-only. Timer start/stop, invoice sending, and money transfers are unavailable.

How to connect

  1. Claude: Open the Hoursmith listing in the Claude connectors directory and choose Connect. Claude listing Hoursmith exposes 124 tools here.
  2. ChatGPT: Open the Hoursmith listing in the ChatGPT app directory and choose Connect. ChatGPT listing Hoursmith exposes 42 tools here.

Tools

archive_project

ChatGPT
Archive (soft-delete) a project — sets deletedAt; it drops out of default lists but tracked time + invoices stay intact for history. This is NOT the same as status=ARCHIVED (use update_project for that). DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Requires a write-scoped Manager+ token.

archive_task

ChatGPT
Archive (soft-delete) a task — tracked time stays intact for invoicing/history. DESTRUCTIVE: requires confirm: true (only pass it after the user explicitly confirmed) and a write-scoped Manager+ token (a Member can edit an assigned task but cannot archive one).

create_client

ChatGPT
Create a new client. Requires a write-scoped Manager+ token (Member tokens get forbidden_scope). Returns the created client with its ID. Only name is required; everything else is optional. Money fields accept a number or a decimal-string.

create_expense

ChatGPT
Record a new expense against a client (and optionally a project under that client). Requires a write-scoped Manager+ token. category is one of: TRAVEL, MEALS, SOFTWARE, EQUIPMENT, CONTRACTORS, OTHER (defaults to OTHER). description is REQUIRED. amount accepts a number or decimal-string (> 0, up to 2 dp). Currency is NOT accepted — the server snapshots the client's currency.

create_project

ChatGPT
Create a new project under a client. Requires a write-scoped Manager+ token. Server-enforced rules: budgetAmount and budgetHours are mutually exclusive; FIXED projects must set fixedFeeAmount and may only use a budgetHours effort cap; dueDate must be ≥ startDate. hourlyRate is required only for HOURLY projects unless the owning client has a defaultRate to inherit. Project rates, fees, and budgets accept a number (30) or decimal-string ("30.00"), with at most 2 decimal places and the documented Decimal-column maximum.

create_task

ChatGPT
Create a new task under a project in the selected workspace; this create operation does not send assignment notifications. Requires a write-scoped token. Manager+ can create + assign current workspace members; a Member may only create tasks assigned to themselves (assigning a teammate → forbidden_scope). billable is a real JSON boolean (true/false); FIXED and NON_BILLABLE projects always store false. estimatedHours accepts a number or decimal-string. endDate must be ≥ startDate.

create_time_entry

ChatGPT
Create a new manual time entry in the selected workspace. Updates project budget totals and may add in-app budget alerts; does not create or send invoices, initiate payments, or start a timer. Send `durationSeconds` (integer) — that's the canonical shape. For 8 hours pass durationSeconds: 28800; for 90 minutes pass 5400. (Legacy alternative: duration as a string like "1h30m", "1:30", "90m", or "1.5h" — the form path. If you pass both, durationSeconds wins.) To record WHEN the work happened, send startTime + endTime as "HH:mm" instead of a duration — the duration is then derived from them. Both or neither. billable is a real boolean (true/false); FIXED and NON_BILLABLE projects always store false, even when true is requested. Owner/Admin can pass userId to log on behalf of a teammate; Manager/Member tokens may only log for themselves. Refuses entries longer than 24 hours.

delete_client

ChatGPT
Permanently delete a client. DESTRUCTIVE and irreversible — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) if the client still has projects, invoices, or time entries — archive those first. Requires a write-scoped Manager+ token.

delete_expense

ChatGPT
Delete (soft-delete) an expense. DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) if the expense is billed on an invoice. Requires a write-scoped Manager+ token.

delete_time_entry

ChatGPT
Delete (soft-delete) a time entry. DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) on invoiced entries.

get_client

ChatGPT
Get a single client by ID. Returns the full client incl. billing address + per-client billing defaults. Requires a Manager+ token — Member tokens get forbidden_scope.

get_connection_profile

ChatGPT
Use this first for conversation context: the acting user/membership, selected workspace, current permissions/plan, date/time preferences, timezone, current local calendar date and app links. Use userId for 'my' work because authorized team lists can contain teammates. Resolve 'today' and 'last week' in this timezone. Present dates through these display preferences: mdy = MM/DD/YYYY, dmy = DD/MM/YYYY, iso = YYYY-MM-DD (numeric dates, even if the prompt uses a month name); medium follows locale; custom uses dateFormatCustom. For times, h12 uses a 12-hour clock with AM/PM and h24 uses a 24-hour clock, in the profile timezone. Timer start/stop is unavailable regardless of read or write consent; do not suggest reauthorization will enable it or substitute a completed time entry. This tool does not switch workspace.

get_expense

ChatGPT
Get an expense by ID. Requires a Manager+ token — Member tokens get forbidden_scope.

get_invoice

ChatGPT
Get a single invoice by ID. Returns the frozen snapshot — bill-to, line items, totals. Manager+ tokens only.

get_me

ChatGPT
Resolve the calling token's identity. Use this first to learn what the token can do. Returns { orgId, orgName, plan, role, tokenName, scopes[] } where role is OWNER/ADMIN/MANAGER/MEMBER and scopes is a subset of ["read","write"]. Member tokens additionally return projectIds — the projects they can see — so you can avoid trial-and-error 404s.

get_member

ChatGPT
Get a member by ID. Member tokens may only fetch their own row (anyone else's id returns 404).

get_organization

ChatGPT
Get details for the organization this token belongs to: name, plan, default currency, invoice prefix, legal name, business contact info. Member tokens receive the identity subset only — invoicePrefix, legalName, taxId, businessEmail, and businessWebsite are omitted for them.

get_project

ChatGPT
Get a project by ID. Applicable money fields come back as decimal strings; hourlyRate is null unless rateType is HOURLY, so a dormant compatibility rate on FIXED/NON_BILLABLE is never presented as live pricing. For Member tokens money and fixed-fee reconciliation fields are omitted entirely — budgetHours stays.

get_running_timer

ChatGPT
Read the currently-running timer for this user (if any). Returns the first running entry or an empty list. This integration cannot start or stop a timer, even with write consent; offer the Hoursmith workspace link instead of requesting broader permission or creating a completed time entry.

get_task

ChatGPT
Get a task by ID. Includes its assignee list (assigneeIds).

get_team_bill

ChatGPT
Get an internal bill's frozen lines, dates, grouped display choices, settlement balances, recorded payment references and latest 50 email delivery summaries plus emailDeliveryCount. Previews, bank details and message content are excluded. Attachment links require an Owner/Admin browser session. Sending email does not mean payment. This tool does not generate, send or pay a bill. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

get_team_payee

ChatGPT
Get one payout recipient's private dated rates, credits, and up to 100 active receiving-method labels plus receivingMethodCount by payee ID. No bank details or encrypted data are returned. Use returned userId to correlate general member data. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

get_team_payment

ChatGPT
Read one recorded payment, actual transfer and bill settlement amounts/currencies, bill references and reversal evidence. The tool never sends money or email. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

get_team_payout_summary

ChatGPT
Get currency-separated compensation awaiting review, outstanding/overdue balances and recorded payments. Dates filter estimates and payments; outstanding/overdue are current balances. Client/project filters select whole matching bills and payments, not prorated amounts. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

get_team_profitability

ChatGPT
Compare configured recipients' compensation with attributed client service revenue, or inspect cash movement. Returns member totals and project details, original-currency amounts, report estimates and missing FX. Page/perPage paginate members; complete filtered totals remain separate. Cash difference is not profit. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

get_time_entry

ChatGPT
Get a single time entry by ID.

list_clients

ChatGPT
List clients in the organization. Returns paginated results — pass cursor from a previous response's pagination.nextCursor to get the next page. Use search for partial-name lookup (e.g. search="Coffee" finds Coffee Coders). Exact country/currency filters accept both a singular value and plural arrays; they merge with duplicates removed. Allowed sort fields: relevance, id, name, createdAt, updatedAt. Prefix with '-' for descending. Default is newest first (-createdAt). Requires a read-scoped Manager+ token — Member tokens get forbidden_scope (Members have no client access in Hoursmith).

list_expenses

ChatGPT
List expenses. Requires a Manager+ token — Member tokens get forbidden_scope. Filter by client, project, category, date range, amount range, or billable flag. Singular and plural exact filters merge and deduplicate before forwarding. Allowed category values: TRAVEL, MEALS, SOFTWARE, EQUIPMENT, CONTRACTORS, OTHER. Allowed sort fields: relevance, id, expenseDate, amount, createdAt, updatedAt. Default -createdAt.

list_invoices

ChatGPT
List invoices. Read-only in v1 — invoice POST/PATCH/DELETE land in v1.1. Manager+ tokens only (Member tokens get forbidden_scope). Recipe — find the latest paid invoice for a client by name in one call: set clientName (partial-match on the client's name), status: "PAID", sort: "-paidAt", limit: 1. Date ranges accept YYYY-MM-DD or full ISO timestamps; numeric ranges accept decimal-strings to preserve precision. Singular and plural exact filters merge and deduplicate before forwarding. Allowed sort fields: relevance, id, number, status, paymentStatus, issueDate, dueDate, sentAt, paidAt, total, amountPaid, createdAt, updatedAt.

list_members

ChatGPT
List members of the organization (Owner/Admin/Manager/Member). Member tokens see only their own row. Allowed sort fields: relevance, id, role, createdAt.

list_projects

ChatGPT
List projects in the organization. Optionally filter by client (id or name) or status. Member tokens see only projects they've been added to, Singular and plural exact filters merge and deduplicate before forwarding. and money/reconciliation fields (hourlyRate, fixedFeeAmount, fixedFeePriorInvoicedAmount, fixedFeeBillingInitializedAt, budgetAmount) are omitted from their results. Allowed sort fields: relevance, id, name, status, startDate, dueDate, createdAt, updatedAt. Default -createdAt.

list_tasks

ChatGPT
List tasks. Optionally filter by project, status, priority, assignee, due date, billable, etc. Member tokens see only their assigned projects' tasks. Singular and plural exact filters merge and deduplicate before forwarding. Billability follows the current project model: only HOURLY project tasks can be billable; billable=false also finds legacy rows on FIXED/NON_BILLABLE projects. Allowed sort fields: relevance, id, name, status, priority, startDate, dueDate, endDate, createdAt, updatedAt. Default -createdAt.

list_team_bills

ChatGPT
List internal compensation bills and balances. Use outstandingOnly=true for unpaid and partially paid approved bills, or overdueOnly=true for overdue balances. Dates select overlapping service periods. Deleted drafts/void bills are omitted; direct get preserves historical references. Allowed sort fields: id, number, status, issueDate, dueDate, total, amountPaid, createdAt, updatedAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

list_team_payees

ChatGPT
List recipients with a configured hourly compensation rate, including retained removed-member profiles. Returns private dated rate history and available credits. Search matches name/email. Allowed sort fields: id, name, createdAt, updatedAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

list_team_payments

ChatGPT
Read prior externally recorded team payments and reversals. Dates filter payment dates. Includes actual cash amount/currency and bill-currency settlement allocations, preserving agreed exchange rates. Filter by billId or status RECORDED/REVERSED. Allowed sort fields: id, paidDate, amount, createdAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

list_team_unpaid_time

ChatGPT
Find priced, unclaimed time awaiting a compensation bill. Running, deleted, pre-start, unpriced and already-approved time is omitted. Defaults to payable work; nonbillable work remains optional and requires explicit bill selection. Dates filter work dates. For already-approved but unpaid work, use list_team_bills with outstandingOnly=true. Allowed sort fields: id, entryDate, durationSeconds, createdAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.

list_time_entries

ChatGPT
List time entries. Filter by project, task, user, date range, billable flag, or set running=true to get the currently-running timer. Singular and plural exact filters merge and deduplicate before forwarding. Billability follows the current project model: only HOURLY project time can be billable; billable=false also finds immutable legacy rows on FIXED/NON_BILLABLE projects. Two different date ranges are available: entryDate* is the calendar day an entry is filed under, startedAt* is when the work actually began. Member tokens are pinned to their own user. Allowed sort fields: relevance, id, entryDate, startedAt, durationSeconds, createdAt, updatedAt. Default is -createdAt (newest first).

update_client

ChatGPT
Overwrite the supplied fields of an existing client; omitted fields are left untouched. Requires a write-scoped Manager+ token. Returns the updated client.

update_expense

ChatGPT
Overwrite the supplied fields of an expense; omitted fields are preserved. Requires a write-scoped Manager+ token. Refuses (409 conflict) if the expense has already been billed on an invoice (billed expenses are locked).

update_project

ChatGPT
Overwrite the supplied fields of a project; omitted fields are preserved. Requires a write-scoped Manager+ token. Use status to mark a project COMPLETED or re-ACTIVATE it. Project Decimal fields accept at most 2 decimal places. Omit a field to preserve it; send null for a nullable field to clear it. Converting away from FIXED requires fixedFeeAmount: null. The same coherence rules as create_project apply when you touch the relevant fields.

update_task

ChatGPT
Overwrite the supplied fields of a task; omitted fields are preserved. Requires a write-scoped token; Members may only edit tasks assigned to them. Adding another current workspace member as an assignee can send the task name and link through external email or linked Telegram providers, according to that recipient's saved notification preferences. Destinations come from the member's existing profile, not a caller-supplied address. Sent notifications cannot be recalled; unchanged assignees, self-assignment and removals do not send assignment notifications. Same field types as create_task — billable is a real boolean and is forced false for FIXED/NON_BILLABLE projects; estimatedHours is a number or decimal-string.

update_time_entry

ChatGPT
Overwrite the supplied fields of a time entry; omitted fields are preserved. Refuses (409 conflict) if the entry is already on an invoiced bill — invoiced entries are immutable. Same dual-input duration rule as create_time_entry: prefer durationSeconds. startTime/endTime behave as they do on create; omit them to leave the entry's bookends alone, or send null for BOTH to clear them. If the target project is FIXED or NON_BILLABLE, billable is always stored as false.

add_expense_to_invoice

Claude

add_project_member

Claude

add_team_pay_rate

Claude

approve_and_pay_team_bill

Claude

approve_team_bill

Claude

archive_project

Claude

archive_task

Claude

archive_team_fixed_pay_agreement

Claude

bulk_delete_time_entries

Claude

bulk_set_time_entries_billable

Claude

cancel_invoice

Claude

clone_recurring_invoice

Claude

correct_invoice

Claude

create_client

Claude

create_client_contact

Claude

create_expense

Claude

create_invoice

Claude

create_project

Claude

create_recurring_invoice

Claude

create_task

Claude

create_task_comment

Claude

create_team_bill_draft

Claude

create_team_bill_drafts_bulk

Claude

create_team_fixed_pay_agreement

Claude

create_time_entry

Claude

delete_client

Claude

delete_client_contact

Claude

delete_expense

Claude

delete_invoice

Claude

delete_task_comment

Claude

delete_team_bill

Claude

delete_time_entry

Claude

discard_timer

Claude

duplicate_invoice

Claude

end_recurring_invoice

Claude

generate_next_recurring_invoice

Claude

get_cash_flow

Claude

get_client

Claude

get_connection_profile

Claude

get_dashboard_overview

Claude

get_expense

Claude

get_invoice

Claude

get_me

Claude

get_member

Claude

get_organization

Claude

get_project

Claude

get_project_archive_impact

Claude

get_project_financials

Claude

get_project_profitability

Claude

get_receivables_summary

Claude

get_recurring_invoice

Claude

get_revenue_report

Claude

get_running_timer

Claude

get_task

Claude

get_task_checklist

Claude

get_team_bill

Claude

get_team_payee

Claude

get_team_payment

Claude

get_team_payout_summary

Claude

get_team_profitability

Claude

get_time_entry

Claude

get_time_summary

Claude

get_uninvoiced_summary

Claude

list_client_contacts

Claude

list_clients

Claude

list_expenses

Claude

list_invoice_activity

Claude

list_invoice_payments

Claude

list_invoices

Claude

list_members

Claude

list_notifications

Claude

list_payment_methods

Claude

list_project_members

Claude

list_projects

Claude

list_ready_to_invoice

Claude

list_recurring_invoice_occurrences

Claude

list_recurring_invoices

Claude

list_task_comments

Claude

list_tasks

Claude

list_team_bills

Claude

list_team_fixed_pay_agreements

Claude

list_team_payees

Claude

list_team_payments

Claude

list_team_payout_methods

Claude

list_team_unpaid_time

Claude

list_time_entries

Claude

mark_invoice_sent

Claude

mark_notifications_read

Claude

pause_recurring_invoice

Claude

preview_invoice

Claude

preview_invoice_email

Claude

preview_team_bill

Claude

preview_team_bills_bulk

Claude

record_invoice_payment

Claude

record_team_payment

Claude

refund_invoice_payment

Claude

remove_project_member

Claude

restore_invoice_to_draft

Claude

restore_project

Claude

restore_task

Claude

resume_recurring_invoice

Claude

reverse_team_payment

Claude

save_team_payee

Claude

send_invoice

Claude

send_invoice_reminder

Claude

set_invoice_reminder_schedule

Claude

set_task_checklist

Claude

skip_recurring_invoice_occurrence

Claude

start_timer

Claude

stop_timer

Claude

undo_skip_recurring_invoice_occurrence

Claude

update_client

Claude

update_client_contact

Claude

update_expense

Claude

update_invoice

Claude

update_organization

Claude

update_project

Claude

update_recurring_invoice

Claude

update_running_timer_note

Claude

update_task

Claude

update_task_comment

Claude

update_team_bill_draft

Claude

update_time_entry

Claude

void_team_bill

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/hoursmith"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/hoursmith)