> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hellotracks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an AI app (MCP)

> Dispatch your field team from Claude, ChatGPT and other AI apps with the Hellotracks connector.

The Hellotracks connector lets an AI app work with your field team in plain words: "who's free this afternoon near Main Street?", "add these five visits for tomorrow and give them to Ana", "plan Ben's day". It is a remote [MCP](https://modelcontextprotocol.io) server:

```
https://mcp.hellotracks.com/mcp
```

Running a field team rather than building something? [Hellotracks in Claude and ChatGPT](https://hellotracks.com/en/ai-apps/) shows what you can ask and how to connect, in plain words.

## Connect

> [tab] Claude
>
> Open **Customize › Connectors** (in Settings it is under **Plugins**), choose **Add › Add custom connector**, give it the name Hellotracks and paste the URL above. Keep the sign-in options Claude detects, then **Connect** and sign in. Once Hellotracks is in the connector directory, pick it there instead.

> [tab] ChatGPT
>
> In Settings › Apps & Connectors › Advanced settings, turn on **Developer mode**. Then choose **Create**, paste the URL above, choose OAuth, and sign in. Business and Enterprise workspaces need an admin to allow developer mode first.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http hellotracks https://mcp.hellotracks.com/mcp
> ```
>
> Then run `/mcp` in Claude Code and sign in.

> [tab] Cursor and others
>
> Add a remote (streamable HTTP) MCP server with the URL above. Any client that supports MCP OAuth signs in by itself.

Signing in happens on a Hellotracks page: your email and password, or leave the password empty and get a 6-digit code by email. Tick **Read only** if the app should only look, not change anything.

Who can connect: company admins. If your account asks for a code by email at sign-in, use the emailed code instead of the password. If it uses an authenticator app, create an API key in the dashboard and use the [`ht` command line](https://api-docs.hellotracks.com/cli/overview) instead.

No account yet? Choose **Create your company** on the same page: your name, email, company name and address, and a code by email. The company starts its free 30-day trial and the app is connected right away. It can then set things up with you: invite your team, add the first jobs and plan their routes.

## What the app can do

47 tools, one for each kind of change, so the app always knows whether a tool only reads, adds, changes or removes something.

| Area | What the app can do | Tools |
| - | - | - |
| Company and people | See the company, its teams and settings, and everyone's day: working hours, last position, jobs by progress, next job. Invite people with their working hours (each gets the app link by email, and by text with a phone number), change them, remove them | `get_company`, `get_team_status`, `find_members`, `invite_members`, `update_company`, `update_members`, `remove_members` |
| Jobs | Find jobs by day, person, progress or text. Add up to 50 at a time, assign them, move them to another day, change the time window or details, archive, restore or delete them | `find_jobs`, `get_job`, `create_jobs`, `update_jobs`, `archive_jobs`, `restore_jobs`, `delete_jobs` |
| Places and routes | Customer sites, depots and zones. Plan one person's day on real roads with working hours, time windows, skills and capacity, and send it to their phone | `find_places`, `find_zones`, `create_places`, `update_places`, `delete_places`, `optimize_route` |
| Links | A live arrival page for a job's customer, or a shared live map; see and revoke them | `create_arrival_link`, `find_arrival_links`, `revoke_arrival_link`, `share_map`, `find_map_links`, `revoke_map_link` |
| Timesheets | Clock-in and clock-out times; add, fix or remove entries | `get_timesheets`, `add_timesheet_entries`, `update_timesheet_entries`, `delete_timesheet_entries` |
| Forms | Checklists and sign-offs workers fill in on the phone: create them, link them to jobs or places, read the answers | `find_forms`, `find_form_answers`, `create_form`, `update_form`, `link_form`, `delete_form` |
| Reports | Preview or run a report, save it to arrive by email on a schedule, send a saved one now | `list_reports`, `preview_report`, `run_report`, `save_report`, `send_saved_report`, `delete_saved_report` |
| Alerts | Read alerts and mark them read; set up rules such as "email me when nobody checked in at the depot by 9" or "when a van stands still for 30 minutes" | `find_alerts`, `create_alert_rules`, `update_alert_rules`, `delete_alert_rules`, `mark_alerts_read` |

Changes reach the workers' phones right away. The app tells you what it is about to change and asks before it does; Claude and ChatGPT also ask you to confirm each tool that changes data. A **Read only** connection can use only the tools that read.

Left out on purpose: API keys and webhooks, because they hand your data to other systems and an instruction hidden in a job note must never be able to set them up. Bulk file import and export and the classic reports stay in the dashboard and in [`ht`](https://api-docs.hellotracks.com/cli/overview).

## Privacy and disconnecting

The connector only talks to Hellotracks. It keeps a key for your company, encrypted, for at most 90 days; disconnecting the app removes the connection and revokes that key (you can also revoke it under Settings › API keys in the dashboard, where it is labelled "(AI connector)"). What the AI app does with the answers is covered by that app's own terms. See our [privacy notice](https://hellotracks.com/en/privacy-notice/).

## For developers

The server is open source in [hellotracks-cli/packages/mcp](https://github.com/Hellotracks/hellotracks-cli/tree/main/packages/mcp). It uses OAuth 2.1 with PKCE and accepts Dynamic Client Registration and Client ID Metadata Documents. If you build your own agent, the [`ht` command line](https://api-docs.hellotracks.com/cli/overview) and the [REST API](https://api-docs.hellotracks.com/v1/overview.md) do everything the connector does and more.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.