Getting started with MyGeotab MCP

Set up the MyGeotab MCP integration, connect your AI assistant, and explore the capabilities and use cases available to your fleet.

This section covers everything you need to start using the MyGeotab MCP integration. Step-by-step setup instructions walk you through confirming your database name, connecting your AI assistant, and running your first query. From there, you can explore the full range of capabilities across 51+ entity types, including data retrieval, modifications, and specialized fleet methods. Common use cases and example prompts are included to help you get value from the integration quickly.

Setting up the MyGeotab MCP integration

Set up the MyGeotab MCP integration by confirming your database name, accessing the MCP-enabled AI assistant, and running your first query.

  1. Confirm your database name.

    Your MyGeotab database name is the unique identifier for your fleet account. You can find it in the URL when logged into MyGeotab.

    Log into MyGeotab and look at the URL in your browser: 
    https://my.geotab.com/[your-database-name]/#

    For example: https://my.geotab.com/myfleet/# means your database name is "myfleet".

  2. Access the MCP-enabled AI assistant.

    During the pilot, the MyGeotab MCP server is pre-configured within Claude.

    1. Open Claude at claude.ai (or your organization's Claude deployment).
    2. Add servers at claude.ai/settings/connectors. On Team and Enterprise plans, only admins can add servers.
    3. Authenticate the MCP server with your MyGeotab credentials. Authentication is handled securely via bearer token; your credentials are not stored in the conversation.
    4. Complete any required authentication steps in claude.ai.
    5. View and manage servers in Claude Code.
  3. Run your first query.

    Once connected, try this prompt to verify everything is working:

    "How many devices are in my MyGeotab database?"

    Claude will call the MCP and return a count of your active devices.

Connecting your AI assistant to MyGeotab MCP

The MyGeotab MCP server supports any MCP-compatible AI client. During the pilot, Claude on claude.ai is the primary supported interface.

Setting

Value

MCP server URL

https://mcp.geotab.com/mygeotab

Protocol

Server-sent events (SSE)

Authentication

Bearer token (handled automatically)

Default server

my.geotab.com

Transport

HTTPS

For advanced users: direct MCP configuration

If you are integrating the MCP server with your own AI tooling or client, use the following JSON configuration:

{
  "mcpServers": {
    "mygeotab": {
      "type": "url",
      "url": "https://mcp.geotab.com/mygeotab",
      "name": "Mygeotab MCP Prod"
    }
  }
}
Note:

Consult your MCP client's documentation for exact configuration steps. The above format follows the standard MCP URL transport specification.

MyGeotab MCP core capabilities

The MyGeotab MCP server supports data retrieval, data modification, and specialized fleet methods across 51+ entity types.

Data retrieval (Get / GetCountOf)

Query any of the 51+ supported entity types in your MyGeotab database. Use filters, date ranges, and field selection to retrieve exactly what you need.

Entity category

Supported types

Devices and assets

Device, Trailer, UntrackedAsset, IoxAddOn

Users and access

User, Driver, Group, SecurityClearance

Trips and location

Trip, LogRecord, StatusData, DeviceStatusInfo

Fault and diagnostics

FaultData, Diagnostic, FailureMode, FlashCode

Compliance and HOS

DutyStatusLog, DutyStatusAvailability, DutyStatusViolation, DVIRLog

Fuel and energy

FillUp, FuelTransaction, FuelUsed, FuelTaxDetail

Zones and routes

Zone, Route

Rules and alerts

Rule, Condition, ExceptionEvent, TextMessage

Notifications

DistributionList, Recipient, EmailTemplate

Reporting

AddIn, AddInData, Audit, CustomReportSchedule

Data modification (Add / Set / Remove)

Create, update, and delete fleet entities directly through natural language commands.

Commands

Action

Add

Create new users, groups, zones, trailers, rules, and more.

Set

Update existing entity properties (names, settings, configurations).

Remove

Delete entities by type (zones, rules, routes, distribution lists, and others).

Specialized methods

Method

Description

DecodeVins

Decode one or more VINs to retrieve make, model, and year information.

GetHosRuleSets

List all available Hours of Service rule sets for driver compliance configuration.

GetPostedRoadSpeedsForDevice

Retrieve historical posted speed limits along a device's travel path.

DismissFaults

Acknowledge and dismiss active fault records after review.

EmissionEnrollDevices

Register vehicles in emission compliance reporting programs.

GetEmissionComplianceDeadline

Check emission compliance deadlines by jurisdiction.

GetAceResults

Query Geotab Ace AI for natural language insights from your fleet data.

SendReportProcessingRequest

Queue scheduled reports for generation in Excel or PDF format.

Example prompts to try for MyGeotab MCP

Use these prompts to explore what the MyGeotab MCP integration can do.

Copy and paste any of these prompts into your AI assistant:

  1. "How many devices are registered in my MyGeotab database [your-db-name]?"

  2. "List all users in my database and show their names and email addresses."

  3. "Get all fault data from the past 7 days for all devices."

  4. "What HOS rule sets are available? Show me all the options."

  5. "Decode this VIN and tell me the vehicle details: [paste VIN here]"

  6. "Create a new group called 'Pilot Test Group' in my database."

  7. "Show me all zones configured in my fleet database."

  8. "Get the posted road speed data for device [device-id] for last month."

  9. "How many trips were recorded across all devices in the last 30 days?"

  10. "Using Geotab Ace, which drivers had the most speeding events this month?"

MyGeotab MCP common use cases

Use the MyGeotab MCP integration for fleet visibility, compliance management, trip analysis, fault management, fleet configuration, VIN decoding, and AI-powered insights.

Fleet visibility and monitoring

Get an instant snapshot of your fleet without logging into the portal.

  • "How many vehicles are currently active in my fleet?"

  • "Which devices have reported faults in the last 7 days?"

  • "Show me the current status of all devices."

  • "List all vehicles in the [group name] group."

Driver and compliance management

Streamline HOS compliance, duty status monitoring, and DVIR workflows.

  • "What HOS rule sets are available for our Canadian drivers?"

  • "Show me all duty status violations from last week."

  • "List drivers with incomplete DVIR logs this month."

  • "What is the emission compliance deadline for our jurisdiction?"

Trip and route analysis

Dive into historical trip data to optimize routes and understand driver behavior.

  • "How many trips did device [X] complete last Monday?"

  • "Get the posted speed limits encountered by vehicle [X] during October."

  • "Show me all trips for the past 30 days filtered by driver."

Fault and maintenance workflows

Identify and manage vehicle faults efficiently without manual portal navigation.

  • "Are there any active fault codes on vehicle [X]?"

  • "Dismiss all acknowledged faults for device [X] after maintenance is complete."

  • "Show me all fault data from the last 30 days sorted by severity."

Fleet configuration and administration

Make bulk or targeted configuration changes through conversational commands.

  • "Create a new geofence zone around [address] with a 500-metre radius."

  • "Add a new driver group called 'Night Shift Fleet'."

  • "Update the name of trailer [X] to reflect its new assignment."

  • "Remove the zone named [X], which is no longer in use."

VIN decoding and vehicle data

Instantly look up vehicle details from VIN numbers, useful for onboarding new vehicles or auditing fleet records.

  • "Decode this VIN: 1HGBH41JXMN109186"

  • "Look up the make, model, and year for these 5 VINs: [list]"

AI-powered fleet insights with Geotab Ace

Ask open-ended fleet questions and let Geotab Ace generate data-driven insights from your private fleet data.

  • "Which drivers have the most harsh braking events this quarter?"

  • "What is my fleet's average fuel efficiency trend over the last 3 months?"

  • "Which vehicles are idling the most and what is the estimated fuel cost?"