Skip to content
MCP server

Timesheets.com MCP by usefulapi

Read users, clock status, items and reports, and create users or assign items in…

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://timesheets-com.usefulapi.io/mcp
Install 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