Overview

The Geotab MCP server is the fleet-telematics implementation of the Model Context Protocol (MCP) — an open standard that lets AI assistants discover and call external tools dynamically. It exposes MyGeotab as AI-callable tools, so any MCP-compatible client — such as Claude, ChatGPT, Microsoft Copilot Studio, Cursor, or VS Code — can query and act on your fleet data in natural language. No SQL, no API code, and no manual report exports are required.

Your AI assistant acts as the front end, the Geotab MCP server acts as the secure bridge to your fleet database, and your MyGeotab account remains the authoritative source of truth. The server runs on Geotab infrastructure, authenticates through Geotab Unified Login, and executes every request under your own MyGeotab identity and clearances.

The server is available at https://mcp.geotab.com/mygeotab and is included with the GO Plan subscription at no additional cost.

Prerequisite: your MyGeotab user must be migrated to Geotab Unified Login before you can connect. See Getting started for the steps.

Capabilities

The MCP server exposes the same data model as the MyGeotab API, organized into AI-discoverable tools. It currently provides roughly 20 tools spanning more than 50 MyGeotab entity types, with token-optimized tool descriptions, structured errors, and multi-call orchestration support. Coverage includes:

  • Devices & assets: Device, DeviceStatusInfo, Trailer, TrailerAttachment
  • Users & access: User, Group, SecurityClearance, and driver lookups
  • Trips & location: Trip, LogRecord, DriverChange, posted-road-speed comparisons
  • Faults & diagnostics: FaultData, StatusData, fault dismissal, VIN decoding
  • HOS & compliance: DutyStatusLog, DutyStatusAvailability, DVIRLog, HOS rule sets
  • Fuel & energy: FuelTransaction, EVStatusInfo, BatteryStateOfHealth, emission enrollment
  • Zones & routes: create and query Zone and Route entities
  • Rules, exceptions & notifications: exception events, notifications, text messages to drivers
  • Reporting & Ace: SendReportProcessingRequest and GetAceResults for natural-language insights powered by Geotab Ace

Specialized tools include DecodeVins, GetHosRuleSets, GetPostedRoadSpeedsForDevice, DismissFaults, EmissionEnrollDevices, and GetEmissionComplianceDeadline. Use ListEntities from any connected client to see the full set of supported entities for your database.

Common use cases

Common workflows include:

  • Fleet visibility: live device status, offline counts, last-known location, vehicle rosters.
  • Driver & compliance: HOS availability, DVIR logs, driver assignment, duty status queries.
  • Trip & route analysis: trip counts, distance and duration aggregates, posted-road-speed comparisons.
  • Fault & maintenance: active fault codes, fault dismissal, recent diagnostics by device.
  • Configuration & setup: create zones, assign drivers, send text messages to vehicles.
  • VIN decoding: bulk VIN lookups for asset onboarding and reconciliation.
  • Ace AI insights: route natural-language analytical queries through Geotab Ace via GetAceResults.
  • Autonomous orchestration: chain calls — for example, detect a fault, check the nearest authorized zone, check driver HOS availability, and send a text message — within a single AI session.
Example prompts

Once connected, you can ask your AI assistant questions like these in plain language. Use them as starting points and adapt them to your fleet.

Fleet status

  • "How many vehicles are in my fleet, and how many are currently offline?"
  • "Where is vehicle 1234 right now?"

Safety & driving

  • "Show the top 5 drivers by harsh-braking events this week."
  • "Which vehicles had speeding exceptions yesterday?"

Compliance

  • "Which drivers are approaching their hours-of-service limits today?"
  • "List DVIR logs with defects from the past 7 days."

Maintenance & faults

  • "What active fault codes do my vehicles have right now?"
  • "Summarize engine faults by device for the last 30 days."

EV & fuel

  • "What is the current state of charge for my electric vehicles?"
  • "Show fuel transactions over $100 last month."

Administration & insights

  • "Decode the VINs for vehicles added in the last 30 days."
  • "Create a zone around this address and notify me when a vehicle enters it."
  • "Use Ace to summarize my fleet's safety performance this quarter."
Getting started

New to MCP? The Getting started with MyGeotab MCP guide on the Geotab Support site walks you through connecting your first client step by step.

Prerequisites

  • An active MyGeotab database and user account with the API access you need.
  • A MyGeotab user migrated to Geotab Unified Login. Most users can self-migrate from their MyGeotab profile page: open the profile menu (top right) → Profile, then enable Unified Login and complete the prompts. After migration, you can connect to the MCP server.
  • An MCP-compatible AI client (Claude, ChatGPT, Microsoft Copilot Studio, Cursor, VS Code).

Using SAML single sign-on? SAML-authenticated MyGeotab accounts cannot connect directly. Use a Basic Authentication account migrated to Unified Login for MCP access, or contact your Geotab account team about migrating your database.

Connection settings

Server URL:    https://mcp.geotab.com/mygeotab
Transport:     Streamable HTTP
Auth:          OAuth 2.1 with PKCE (secure browser sign-in; no credentials stored)
Default DB:    my.geotab.com (override per request if needed)

Step 1: Add the server to your AI client

Most MCP-compatible clients have a Connectors or MCP serverssettings panel. Add a new custom server and paste the URL above. On first use, the client redirects you to Geotab's sign-in page; after you authenticate, the client receives a scoped token and the connection is authorized. Your MyGeotab password is never entered into or stored by the AI client.

Claude (Web, Desktop, Team, Enterprise)

Open Settings → Connectors → Add custom connector and paste https://mcp.geotab.com/mygeotab. Claude prompts for Geotab authorization on first query. On Team and Enterprise plans, only administrators can add connectors.

Claude Desktop (config file)

Edit claude_desktop_config.json (typically at ~/.config/claude/claude_desktop_config.json on macOS/Linux or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "geotab": {
      "url": "https://mcp.geotab.com/mygeotab"
    }
  }
}

ChatGPT

In ChatGPT, open Settings → Connectors → Add custom connector (available on Plus, Pro, Business, and Enterprise plans with developer mode enabled). Provide the following:

  • Name: Geotab
  • MCP server URL: https://mcp.geotab.com/mygeotab
  • Authentication: OAuth

Save the connector, then enable it inside a chat by selecting it from the connector picker. ChatGPT prompts for Geotab authorization on first use.

Microsoft Copilot Studio

Add the Geotab MCP server as a custom connector / tool, using the URL https://mcp.geotab.com/mygeotab and OAuth authentication. Agents in Copilot Studio can then call MyGeotab tools directly.

Cursor

In Cursor, open Settings → MCP → Add custom MCP server. Cursor opens an mcp.json file where you add the server configuration:

{
  "mcpServers": {
    "MyGeotab": {
      "url": "https://mcp.geotab.com/mygeotab"
    }
  }
}

Cursor separates Home MCP servers (for local development) from Cloud MCP servers (for remote use). Add the configuration under whichever fits your workflow — or under both if you want the connection available in each context.

VS Code with GitHub Copilot

Add the following to .vscode/mcp.json:

{
  "servers": {
    "geotab": {
      "url": "https://mcp.geotab.com/mygeotab"
    }
  }
}

Step 2: Try a first query

Once connected, confirm everything works with a quick question such as "How many vehicles do I have in MyGeotab?" — then explore the example prompts for more ideas.

Security & data handling

Authentication & authorization

The MCP server authenticates through Geotab Unified Login using OAuth 2.1 with PKCE. On first connection, your AI client redirects you to Geotab's sign-in page; after you authenticate, the client receives a scoped token that the MCP server validates on every request. Your AI client never sees your MyGeotab password.

All API calls execute under your MyGeotab user identity and clearances — the MCP server cannot return data your account is not authorized to view.

Data handling

  • Fleet data:retrieved in real time from the MyGeotab API. The MCP server does not store copies of your fleet records, and fleet data is not routed through the AI vendor's servers unless you explicitly include it in your prompt.
  • Operational logging: Geotab logs each request for support, reliability, and security. Passwords and other credentials are redacted before logging.
  • Data residency: operational log data is stored at rest in regional datasets aligned to your MyGeotab data region — currently the United States, Europe, Canada, Australia, Asia, and Brazil.
  • Audit logging: MCP activity surfaces in your MyGeotab AuditLog where applicable.
  • Rate limits: MyGeotab API rate limits apply and are passed through to the client as structured errors.

Revoking access

Disconnect the server from your AI client to immediately stop new requests. You can also revoke access through your Geotab Unified Login account settings.

Known limitations

The following are intentionally not exposed:

  • Auth methods: Authenticate and SetUserPassword are not callable via MCP — authentication is handled by the Unified Login flow.
  • Destructive removes: Remove is blocked for Device, User, Group, FuelTransaction, Trailer, TrailerAttachment, MediaFile, and TextMessage to protect against accidental data loss.
  • Federal databases: FedRAMP-authorized databases are not supported at this time.

For mission-critical or high-volume integrations that fall outside the MCP scope, use the MyGeotab SDK directly.

FAQ

Which AI clients are supported?

Any client that implements the Model Context Protocol — including Claude (Web, Desktop, Team, Enterprise), ChatGPT, Microsoft Copilot Studio, Cursor, VS Code with GitHub Copilot, and custom agents built with an MCP SDK. If your client supports adding a custom Streamable HTTP server, it should work. Support for Google Gemini is planned.

Is there a separate price for MCP?

MCP access is included with the GO Plan subscription at no additional cost.

What data can I access?

The same data model as the MyGeotab API — devices, drivers, trips, zones, HOS, DVIR, exceptions, faults, fuel, EV status, audit logs, and more. Access is scoped to your account's clearances.

What do I need before I can connect?

An active MyGeotab account with API access, and a user migrated to Geotab Unified Login. Most users can self-migrate from their MyGeotab profile page. If your account uses SAML single sign-on, use a Basic Authentication account migrated to Unified Login, or contact your Geotab account team.

How do I report issues or request features?

Contact your Geotab account team or post in the Geotab Developer Community.

Resources