# Timesheets.com MCP by usefulapi

> Timesheets.com MCP by usefulapi is a freemium MCP server for hiring and recruiting. Hosted MCP server connecting AI clients to Timesheets.com users, clock status and reports. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/timesheets-com/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timesheets-com
- **MCP Registry name:** io.usefulapi/timesheets-com
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-18

## About

The server gives an AI assistant read access to Timesheets.com data such as user lists, live clock status, project timers and hourly or payroll reports. A smaller set of tools can create users, assign customers, projects or account codes to them, and manage vendors and events.

It runs remotely at a hosted endpoint, so there is nothing to install locally. Sign-in is handled through OAuth: the login page asks for a Timesheets.com API key and authorization token, which a Primary Administrator creates in the Timesheets.com API dashboard. The README says these credentials are stored per user rather than placed in config files.

It suits payroll and operations staff who already track hours in Timesheets.com and want to ask questions about attendance or payroll periods in plain language. Write tools are marked separately so clients can ask for confirmation before changing data. The service is operated by usefulapi and is not an official Timesheets.com product.

## Features

- **Clock status lookup:** Shows who is clocked in, break times and hours for the current shift or day.
- **Hourly and project reports:** Builds time reports for a date range, grouped or detailed, by user, customer or project.
- **Payroll preview:** Previews a hourly payroll run for chosen users without closing the payroll period.
- **User and item assignment:** Adds customers, projects or account codes to users and sets defaults, with a separate removal tool.
- **Invite new users:** Creates a user and can send the invitation email when requested.
- **Expense and vendor records:** Reads expense reports and creates or updates vendors and events.

## Good for

- Check which employees are currently clocked in and which are on running project timers
- Generate a monthly hourly report grouped by customer for billing review
- Preview payroll for a date range before a period is closed
- Assign several employees to a customer and set it as their default
- Invite a new employee to the company account from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http timesheets-com https://timesheets-com.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://timesheets-com.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "timesheets-com": {
      "url": "https://timesheets-com.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "timesheets-com": {
      "type": "http",
      "url": "https://timesheets-com.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "timesheets-com": {
      "serverUrl": "https://timesheets-com.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "timesheets-com": {
      "type": "http",
      "url": "https://timesheets-com.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## FAQ

### Is this an official Timesheets.com product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Timesheets.com.

### What credentials are needed to connect?

The login page asks for a Timesheets.com API key and authorization token. A Primary Administrator creates both in the Timesheets.com API settings.

### Can the AI change data in Timesheets.com?

Yes, through seven tools that create or change data. The other tools are read-only, and most MCP clients ask for approval before a tool runs.

### What does it cost?

The free plan allows 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each subscription covers this server only.

### Is Timesheets.com MCP by usefulapi free?

Timesheets.com MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### 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

### What are the best alternatives to Timesheets.com MCP by usefulapi?

The closest alternatives to Timesheets.com MCP by usefulapi are Reactive Resume, Joboracle, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages and Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Joboracle](https://ai-powered.com/mcp/joboracle): Joboracle is a freemium MCP server for hiring and recruiting.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/timesheets-com-mcp-by-usefulapi
