--- title: Getting Started With the Timeero MCP Integration description: Learn what Timeero MCP is, how it connects AI assistants like Claude and ChatGPT to your Timeero data, what permissions you control, and how to set it up. --- [Skip to content](https://help.timeero.com/how-to-use-the-timeero-mcp-integration#main-content) English Show submenu for translations [![logo - 512.png\]](https://help.timeero.com/hs-fs/hubfs/logo%20-%20512.png?width=75&height=75&name=logo%20-%20512.png)](https://timeero.com) Open main navigation Close main navigation - English Show submenu for translations - [Go to timeero.com](https://timeero.com/) [Go to timeero.com](https://timeero.com/) Help Center - There are no suggestions because the search field is empty. 1. [Help Center](https://help.timeero.com/?hsLang=en) 2. [Integrations](https://help.timeero.com/integrations?hsLang=en) 3. [MCP](https://help.timeero.com/integrations?hsLang=en#mcp) # Getting Started With the Timeero MCP Integration ## Learn what an MCP server is and how to use it with Timeero.  ### ![Premium Plan](https://help.timeero.com/hs-fs/hubfs/Premium%20Plan.png?width=85&height=52&name=Premium%20Plan.png) ### 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/mcp](https://mcp.timeero.com/mcp). 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](https://developers.timeero.com/reference/overview). - 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](https://help.timeero.com/hs-fs/hubfs/timeero-mcp-architecture-1.png?width=670&height=227&name=timeero-mcp-architecture-1.png) 1. You connect an MCP client to through this url [https://mcp.timeero.com/mcp](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](https://help.timeero.com/public-api-integration?hsLang=en)). - 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](https://mcp.timeero.com/mcp/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. ](https://help.timeero.com/how-to-set-up-the-mcp-for-claude?hsLang=en) - [ChatGPT Setup. ](https://help.timeero.com/how-to-set-up-the-mcp-for-chatgpt?hsLang=en) - [Cursor and other IDEs Setup. ](https://help.timeero.com/how-to-set-up-the-mcp-for-cursor-and-other-ides?hsLang=en) \*If you have any further questions or need help troubleshooting please see our [FAQ and Troubleshooting Article Here. ](https://help.timeero.com/mcp-faqs-and-troubleshooting-guide?hsLang=en)   - [Getting Started](https://help.timeero.com/getting-started?hsLang=en#main-content) - [First Steps](https://help.timeero.com/getting-started?hsLang=en#first-steps) - [Users](https://help.timeero.com/getting-started?hsLang=en#users) - [Jobs & Tasks](https://help.timeero.com/getting-started?hsLang=en#jobs-tasks) - [Scheduling](https://help.timeero.com/getting-started?hsLang=en#scheduling) - [Company Settings](https://help.timeero.com/company-settings?hsLang=en#main-content) - [Main Settings](https://help.timeero.com/company-settings?hsLang=en#main-settings) - [Break Settings](https://help.timeero.com/company-settings?hsLang=en#break-settings) - [Premium Settings](https://help.timeero.com/company-settings?hsLang=en#premium-settings) - [Billing](https://help.timeero.com/billing?hsLang=en) - [Advanced Tracking Options](https://help.timeero.com/advanced-tracking-options?hsLang=en#main-content) - [Auto Clock In/ Out](https://help.timeero.com/advanced-tracking-options?hsLang=en#auto-clock-in-out) - [Timesheets, Mileage & Location Tracking](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#main-content) - [Time & Mileage page on the Web Portal](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#time-mileage-page-on-the-web-portal) - [Entries Tab on the Mobile App](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#entries-tab-on-the-mobile-app) - [Kiosk App](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#kiosk-app) - [Multi-Level Approvals](https://help.timeero.com/timesheets-mileage-location-tracking?hsLang=en#multi-level-approvals) - [Integrations](https://help.timeero.com/integrations?hsLang=en#main-content) - [Gusto](https://help.timeero.com/integrations?hsLang=en#gusto) - [ADP Workforce Now](https://help.timeero.com/integrations?hsLang=en#adp-workforce-now) - [ADP RUN](https://help.timeero.com/integrations?hsLang=en#adp-run) - [QuickBooks Online](https://help.timeero.com/integrations?hsLang=en#quickbooks-online) - [Zapier](https://help.timeero.com/integrations?hsLang=en#zapier) - [Paychex](https://help.timeero.com/integrations?hsLang=en#paychex) - [Sandata EVV](https://help.timeero.com/integrations?hsLang=en#sandata-evv) - [Paylocity](https://help.timeero.com/integrations?hsLang=en#paylocity) - [Rippling](https://help.timeero.com/integrations?hsLang=en#rippling) - [QuickBooks Desktop](https://help.timeero.com/integrations?hsLang=en#quickbooks-desktop) - [Xero](https://help.timeero.com/integrations?hsLang=en#xero) - [PIMSY](https://help.timeero.com/integrations?hsLang=en#pimsy) - [Paycor](https://help.timeero.com/integrations?hsLang=en#paycor) - [Sage Intacct](https://help.timeero.com/integrations?hsLang=en#sage-intacct) - [Viventium](https://help.timeero.com/integrations?hsLang=en#viventium) - [BambooHR](https://help.timeero.com/integrations?hsLang=en#bamboohr) - [MCP](https://help.timeero.com/integrations?hsLang=en#mcp) - [Reports](https://help.timeero.com/reports?hsLang=en) - [Employee Resources](https://help.timeero.com/employee-resources?hsLang=en#main-content) - [Getting Started](https://help.timeero.com/employee-resources?hsLang=en#getting-started) - [Configure Settings](https://help.timeero.com/employee-resources?hsLang=en#configure-settings) - [Managing Time & Mileage](https://help.timeero.com/employee-resources?hsLang=en#managing-time-mileage) - [Time Off Management](https://help.timeero.com/time-off-management?hsLang=en) - [In-App Messaging](https://help.timeero.com/in-app-messaging?hsLang=en#main-content) - [Message Blasts](https://help.timeero.com/in-app-messaging?hsLang=en#message-blasts) - [Product Updates](https://help.timeero.com/product-updates?hsLang=en) - [Frequently Asked Questions](https://help.timeero.com/frequently-asked-questions?hsLang=en) # Timeero For further assistance, contact our support team: +1 (888) 998-0852 or email us: hello@timeero.com © 2026 by Timeero LLC.