Skip to content
English
Go to timeero.com
  • There are no suggestions because the search field is empty.

Getting Started With the Timeero MCP Integration

Learn what an MCP server is and how to use it with Timeero. 

Premium Plan

What is the Timeero MCP?

  • MCP stands for Model Context Protocol. It is an open standard that lets AI assistants securely call tools on your behalf.

  • Timeero MCP is a remote MCP server hosted by Timeero at https://mcp.timeero.com/. After you authorize with your Public API key, an MCP client can use Timeero tools to read - and, if you allow it, write or delete - data available through the Public API.

  • Timeero MCP is not a replacement for the Public API. The Public API is the REST API developers use directly; Timeero MCP is a secure bridge for natural-language access.

 

What can I use the Timeero MCP for?

  • Ask natural-language questions instead of writing API scripts or exporting spreadsheets.
  • Get manager-friendly reports (employee summaries; time and mileage by user, group, job, task, date range, or mileage).
  • Work with users, groups, jobs, tasks, timesheets, schedules, breaks, custom fields, GPS locations, and time off.
  • Control write and delete access when you connect - or change it later under Manage permissions.

Example prompts:

  • “Summarize how Jane is doing this week.” 

  • “Who is currently clocked in?”

  • “Show time and mileage for the Field Crew group last week.”

*Note: Hours and mileage reports cover a maximum of 366 days per request. Schedule and time-off lists are limited to 30 days.

 

How Does it work?

timeero-mcp-architecture-1
  1. You connect an MCP client to this url https://mcp.timeero.com/mcp.
  2. Copy and paste your Timeero Public API key and choose Read/Write/Delete permissions.
  3. The client sends tool requests to the Timeero MCP server.
  4. The server calls the Timeero Public API and returns results to the client.

 

What is Required to use the MCP?

  • A Timeero account on a Premium plan with Public API access.
  • A Public API key from Integrations → Public API → Configuration (see Public API Integration).
  • An MCP-compatible client (Claude, ChatGPT, Cursor, or another remote HTTP MCP client).

 

What Permissions (all clients) are Needed?

  • Read - always included.
  • Write - optional (create/update, clock in/out, approve timesheets, manage schedules).
  • Delete - optional (permanently delete groups, jobs, tasks, timesheets, schedules, breaks).

Change access later at Manage permissions, then start a new chat so the client reloads tools.

 

How do I Connect Specific Clients?

Select the corresponding link below to see the Help Center Article for each client:

  • Claude Setup. 
  • ChatGPT Setup. 
  • Cursor and other IDEs Setup. 

*If you have any further questions or need help troubleshooting please see our FAQ and Troubleshooting Article Here.