MCP server
Timesheets.com MCP by usefulapi
Read users, clock status, items and reports, and create users or assign items in…
- Runs
- Remotely
- Version
- 1.7.0
- Listing updated
- 5 days ago
About Timesheets.com MCP by usefulapi
Timesheets.com MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read users, clock status, items and reports, and create users or assign items in Timesheets.com.
Install
Run in a terminal
claude mcp add --transport http timesheets-com https://timesheets-com.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://timesheets-com.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"timesheets-com": {
"url": "https://timesheets-com.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"timesheets-com": {
"type": "http",
"url": "https://timesheets-com.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"timesheets-com": {
"serverUrl": "https://timesheets-com.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"timesheets-com": {
"type": "http",
"url": "https://timesheets-com.usefulapi.io/mcp"
}
}
}Tools this server provides (22)
Read directly from the server.
- timesheets_list_users
- List users of the company, with UserID, name, email, access level and status. Filter by user ids and status. Timesheets API: GET /users.
- timesheets_get_user_info
- Get report details for users: name, pay and tracking settings, supervisor. Empty user_ids returns all users. Timesheets API: GET /report/user/info.
- timesheets_create_user
- Create a user in the company. Sends an invitation email only when send_notification_email is true (default false). Timesheets API: POST /user.
- timesheets_assign_user_items
- Add customers, projects or account codes to a user. Existing assignments stay. Set defaults with default_id (customer, project) or the default_*_id fields (accountcode). Timesheets API: POST /user/{UserID}/customers|projects|accountcodes.
- timesheets_unassign_user_items
- Remove customers, projects or account codes from a user. Only the listed ids are removed. Removing a default resets it to the company default. Timesheets API: DELETE /user/{UserID}/customers|projects|accountcodes.
- timesheets_list_items
- List customers, projects, account codes, vendors or events. Filter by status, text and ids. Timesheets API: GET /items/{kind}.
- timesheets_get_item
- Get one customer, project, account code, vendor or event by id. Timesheets API: GET /item/{kind}/{id}.
- timesheets_create_vendor
- Create a vendor (used on expense records). Timesheets API: POST /item/vendor/0.
- timesheets_update_vendor
- Change fields of one vendor. Only the given fields change. Timesheets API: PATCH /item/vendor/{id}.
- timesheets_create_event
- Create an event (an expense or activity tag). Timesheets API: POST /item/event/0.
- timesheets_update_event
- Change the name or description of one event. Timesheets API: PATCH /item/event/{id}.
- timesheets_get_clock_shift
- Get a user's current clock status: clock-in and break times, location, hours for the shift and for today. Needs admin access to that user. Timesheets API: GET /clock/shift/user/{UserID} (key only).
- timesheets_list_clock_shifts
- List clock status for several users, or for the users one supervisor manages. Timesheets API: GET /clock/shift/users (key only).
- timesheets_list_project_timers
- List a user's running project timers, optionally by customer, project or account code. Timesheets API: GET /project/timers/{UserID}.
- timesheets_get_record_history
- Get the revision history of one hourly, project or expense record. Needs admin access to the record's employee. Timesheets API: GET /record/{kind}/history/{RecordID}.
- timesheets_get_hourly_report
- Get an hourly time report for a date range, grouped and summarised or detailed. Processed = approved and finished records; unprocessed = the rest. Timesheets API: POST /report/hourly/customizable/{processed|unprocessed}.
- timesheets_list_payroll_periods
- List hourly payroll periods that start and end in a date range. Timesheets API: GET /report/hourly/payroll/periods.
- timesheets_get_payroll_period
- Get the hourly payroll report of one period, optionally for some users. Timesheets API: GET /report/hourly/payroll/period/{PayrollID}.
- timesheets_preview_payroll
- Preview the hourly payroll for a date range and users. It is a preview: the call does not close a payroll period. Timesheets API: POST /report/hourly/payroll/preview.
- timesheets_get_project_report
- Get a project time report for a date range, by user, customer, project or account code. Timesheets API: POST /report/project/customizable.
- timesheets_get_expense_report
- Get an expense report for a date range, by user, vendor, event, customer, project or account code. Timesheets API: POST /report/expense/customizable.
- timesheets_get_server_reference
- Get the company's enum constants (user statuses, access types, record statuses) or the timezone ids used by timesheets_create_user. Timesheets API: GET /server/constants or /server/timezones.
Timesheets.com MCP by usefulapi FAQ
How do I add Timesheets.com MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http timesheets-com https://timesheets-com.usefulapi.io/mcp