This is not a reporting wrapper: most groups support create, update and delete, and expenses and mileage carry their own status transitions and status history. The API key you hand it is the boundary — an agent with it can approve an expense or delete a project as easily as it can list one.
A single-file JavaScript server covering TimeChimp API v2. It exposes 46 tools across ten resource groups, and passes OData conventions through, so `$filter`, `$orderby`, `$expand`, `$count` and pagination all work the way they do in the underlying API.
- Projects created, read, updated and deleted, plus per-project insights — `get_projects`, `get_project_by_id`, `create_project`, `update_project`, `delete_project`, `get_project_insights`
- Users with their roles, contracts and tags — `get_users`, `get_user_by_id`, `create_user`, `update_user`
- Time entries fetched over a date range, filtered by user or project — `get_time_entries`, `get_time_entry_by_id`
- Contacts and customers over their full lifecycle — `get_contacts`, `create_contact`, `update_contact`, `delete_contact`, `get_customers`, `create_customer`, `update_customer`, `delete_customer`
- Expenses with an approval workflow: create, edit, delete, move status, move client status, and read the status history — `create_expense`, `update_expense`, `update_expense_status`, `update_expense_client_status`, `get_expense_status_history`
- Mileage with the same status handling plus vehicle assignment — `create_mileage`, `update_mileage_status`, `get_mileage_status_history`, `get_mileage_vehicles`
- Tasks, invoices and tags for filtering and reporting — `get_tasks`, `get_invoices`, `get_tags`
A TimeChimp account with API access and its key in `TIMECHIMP_API_KEY`, from your profile settings' API section. Node.js 18.0.0 or higher. Runs as a Node process against `timechimp-mcp-server.js` with the repository as the working directory.
One command plus a key — npx -y github:Sungdaddy/TimeChimpMCP, then supply credentials