usefulapiFleetio MCP server
Read Fleetio vehicles, work orders, service, issues, inspections, fuel, parts; log issues, meters. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.
What can I ask?
Turn on the Fleetio connector, then ask in plain words. The AI picks the tools.
- Which of our vehicles have open work orders right now, and which shop has each one?
- List service reminders marked due soon for our delivery vans.
- How much did we spend on fuel last month across all vehicles?
- Log an issue for the van named Van 12: the left brake light is out.
What you can do with Fleetio in Claude and ChatGPT
For fleet managers who track vehicles and maintenance in Fleetio.
Find vehicles with open work orders
The AI lists work orders by status such as Open, with vehicle, vendor and technician, and opens one for its line items.
Check service reminders that are due
The AI lists preventive-maintenance reminders by status (due soon or overdue), with next-due dates and meter values, and vehicle renewal reminders.
Sum up fuel spending
The AI lists fuel entries by vehicle, vendor or date with volume, price, cost and efficiency, and totals the cost.
Review the service history of a vehicle
The AI finds a vehicle, lists its service entries and meter readings, and lists the line items of an entry.
Look at issues, faults and failed inspections
The AI lists reported issues by state, telematics fault codes, and submitted inspections with the number of failed items.
Log an issue or meter reading, or add a comment
The AI creates an issue for a vehicle or equipment, records an odometer or engine-hour reading, or adds a comment to a record.
Changes dataHow do I connect Fleetio?
Before you connect
The login page asks for your Fleetio API key and Fleetio Account-Token.
Create a key at secure.fleetio.com/api_keys (Account menu → Manage API Keys); the Account-Token is shown at the bottom of that page. API access needs the Professional or Premium plan. The key acts with the permissions of the user who created it, so a dedicated user is a good idea. Your credentials are used only to call the Fleetio API on your behalf; they are never shown to anyone.
Claude claude.ai · Desktop
- Open Customize → Connectors, then click + Add → Add custom connector.
- Enter the name Fleetio and this URL, then click Add:https://
fleetio. usefulapi. io/ mcp - Claude opens the login page: enter your Fleetio API key and Fleetio Account-Token.
- In a chat, click + → Connectors and turn on Fleetio.
Team and Enterprise: an Owner adds the connector for the organization first.
ChatGPT chatgpt.com
- Open Plugins, click +, then Add custom MCP server.
- Enter the name Fleetio and this URL, choose OAuth as the authentication, confirm the warning and create it:https://
fleetio. usefulapi. io/ mcp - ChatGPT opens the login page: enter your Fleetio API key and Fleetio Account-Token.
- In Plugins, install Fleetio, then choose it in a chat.
No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.
Claude Code
Run this command, then run /mcp in Claude Code to log in:
Cursor
Add to Cursor or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"fleetio": {
"url": "https://fleetio.usefulapi.io/mcp"
}
}
} VS Code
Add to VS Code or add this to .vscode/mcp.json:
{
"servers": {
"fleetio": {
"type": "http",
"url": "https://fleetio.usefulapi.io/mcp"
}
}
} Codex
Run these commands. The second one opens the login page:
Other clients
Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.
Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your Fleetio API key and Fleetio Account-Token. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Proper account | $9/mo · $90/yr | 10,000 tool calls / month |
| Pro+per account | $39/mo · $390/yr | 100,000 tool calls / month |
Each paid plan covers this Fleetio server only. Ask your AI to run fleetio_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with fleetio_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with fleetio_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
Tools 48
Show all 48 tools (the AI picks them for you)
Read only · 41
- List accounts
fleetio_list_accountsThe Fleetio account(s) this API key belongs to: id, name, address, plan, units and the key's user type. The Account-Token and permission flags are never returned. - List vehicles
fleetio_list_vehiclesList vehicles (not archived) with status, type, group, meter readings, VIN and license plate. Filter by name, VIN, plate, group, status or type; ids for the filters come from the lookup tools (fleetio_list_vehicle_statuses, fleetio_list_vehicle_types, fleetio_list_groups). GET /vehicles. Returns one page (keyset paging: pass next_cursor as start_cursor). - List a vehicle's meter entries
fleetio_list_vehicle_meter_entriesList the odometer / engine-hour meter readings of ONE vehicle, newest first by default. GET /vehicles/{id}/meter_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). - List meter entries
fleetio_list_meter_entriesList meter readings across the account. Filter by vehicle and by date. GET /meter_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). - List vehicle assignments
fleetio_list_vehicle_assignmentsList which driver (contact) was assigned to which vehicle and when; filter by vehicle or contact. GET /vehicle_assignments. Returns one page (keyset paging: pass next_cursor as start_cursor). - List equipment
fleetio_list_equipmentList equipment (non-vehicle assets such as trailers and tools). GET /equipment. Returns one page (keyset paging: pass next_cursor as start_cursor). - List work orders
fleetio_list_work_ordersList work orders (shop jobs) with status, vehicle, vendor and technician. Filter by vehicle, vendor, technician, number or status name (for example Open). A finished work order produces a service entry. GET /work_orders. Returns one page (keyset paging: pass next_cursor as start_cursor). - List service entries
fleetio_list_service_entriesList service entries (completed maintenance records) with vehicle, vendor, dates and notes. Filter by reference or completion date. GET /service_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). - List a vehicle's service entries
fleetio_list_vehicle_service_entriesList the service entries of ONE vehicle. GET /vehicles/{id}/service_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). - List service reminders
fleetio_list_service_remindersList preventive-maintenance service reminders with next-due dates and meter values. Filter by status (ok, due_soon, overdue, snoozed), vehicle or service task. GET /service_reminders. Returns one page (keyset paging: pass next_cursor as start_cursor). - List issues
fleetio_list_issuesList issues (defects and problems reported against vehicles and equipment) with state, priority, assignees and due date. Filter by state, vehicle, equipment or reporter. GET /issues. Returns one page (keyset paging: pass next_cursor as start_cursor). - List faults
fleetio_list_faultsList diagnostic trouble codes (faults) reported by telematics devices, with vehicle, code and last occurrence. GET /faults. Returns one page (keyset paging: pass next_cursor as start_cursor). - List inspection forms
fleetio_list_inspection_formsList the inspection form templates (for example a daily DVIR) defined in the account. GET /inspection_forms. Returns one page (keyset paging: pass next_cursor as start_cursor). - List submitted inspections
fleetio_list_submitted_inspectionsList submitted inspections (filled-in forms) with the vehicle, the driver, the number of failed items and the submit time. GET /submitted_inspection_forms. Returns one page (keyset paging: pass next_cursor as start_cursor). - List fuel entries
fleetio_list_fuel_entriesList fuel purchases/fill-ups with vehicle, volume, price, total cost and efficiency. Filter by vehicle, vendor or date. Fuel-card data is never returned. GET /fuel_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). - List parts
fleetio_list_partsList parts (inventory catalog) with part number, manufacturer number, category and unit cost. Filter by part number, manufacturer part number or UPC. GET /parts. Returns one page (keyset paging: pass next_cursor as start_cursor). - List part stock by location
fleetio_list_part_stockList on-hand inventory of parts per part location (quantity by location). Filter by part or part location. GET /part_location_details. Returns one page (keyset paging: pass next_cursor as start_cursor). - List contacts
fleetio_list_contactsList contacts (drivers, technicians, employees) with name, email, phones, job title and group. Birth dates and driver-licence data are never returned. Filter by email, last name or group. GET /contacts. Returns one page (keyset paging: pass next_cursor as start_cursor). - List vendors
fleetio_list_vendorsList vendors (repair shops, fuel stations, parts suppliers) with address and contact details. GET /vendors. Returns one page (keyset paging: pass next_cursor as start_cursor). - List vehicle renewal reminders
fleetio_list_vehicle_renewal_remindersList vehicle renewal reminders (registration, insurance, inspections due) with next-due dates. Filter by vehicle or status. GET /vehicle_renewal_reminders. Returns one page (keyset paging: pass next_cursor as start_cursor). - List comments
fleetio_list_commentsList comments left on records. Filter by the record: commentable_type (Issue, WorkOrder, ServiceEntry, Vehicle, ...) + commentable_id. GET /comments. Returns one page (keyset paging: pass next_cursor as start_cursor). - List vehicle statuses
fleetio_list_vehicle_statusesLookup: the vehicle statuses (Active, In Shop, Out of Service, ...) and their ids for filtering vehicles. GET /vehicle_statuses. Returns one page (keyset paging: pass next_cursor as start_cursor). - List vehicle types
fleetio_list_vehicle_typesLookup: the vehicle types (Car, Truck, Van, ...) and their ids. GET /vehicle_types. Returns one page (keyset paging: pass next_cursor as start_cursor). - List work order statuses
fleetio_list_work_order_statusesLookup: the work order statuses (Open, In Progress, Completed, ...). GET /work_order_statuses. Returns one page (keyset paging: pass next_cursor as start_cursor). - List issue priorities
fleetio_list_issue_prioritiesLookup: the issue priorities and their ids (needed to create an issue with a priority). GET /issue_priorities. Returns one page (keyset paging: pass next_cursor as start_cursor). - List groups
fleetio_list_groupsLookup: the groups (locations/departments) and their ids. GET /groups. Returns one page (keyset paging: pass next_cursor as start_cursor). - List labels
fleetio_list_labelsLookup: the labels (tags) used on vehicles, issues, work orders and service entries. GET /labels. Returns one page (keyset paging: pass next_cursor as start_cursor). - List service tasks
fleetio_list_service_tasksLookup: the service tasks (Oil Change, Tire Rotation, ...) and their ids. GET /service_tasks. Returns one page (keyset paging: pass next_cursor as start_cursor). - List places
fleetio_list_placesList places (geofences/locations) with address, coordinates and radius. GET /places. Returns one page (keyset paging: pass next_cursor as start_cursor). - Get vehicle
fleetio_get_vehicleOne vehicle with full detail: status, type, group, meters, VIN, make/model/year, license plate, dates. - Get equipment
fleetio_get_equipmentOne equipment record with full detail. - Get work order
fleetio_get_work_orderOne work order with full detail (status, vendor, technician, dates, totals). - Get service entry
fleetio_get_service_entryOne service entry with full detail (vehicle, vendor, notes, meter readings, totals). - Get part
fleetio_get_partOne part with full detail (number, manufacturer, category, costs). - Get contact
fleetio_get_contactOne contact (driver/technician/employee). Birth date and driver-licence data are never returned. - Get vendor
fleetio_get_vendorOne vendor with full detail. - Get submitted inspection
fleetio_get_submitted_inspectionOne submitted inspection with every item's result (pass/fail/remarks), the vehicle, driver and any resulting work order. - Get inspection form
fleetio_get_inspection_formOne inspection form template with its items. - Get issue
fleetio_get_issueOne issue with full detail (state, priority, asset, reporter, due date, resolution). Optionally include comments, labels, the asset, custom fields, documents or images. - List work order line items
fleetio_list_work_order_line_itemsThe line items (labor, parts, fees) of ONE work order. - List service entry line items
fleetio_list_service_entry_line_itemsThe line items (tasks, parts, labor) of ONE service entry.
Changes data · 3
- Create issue
fleetio_create_issueWRITE: create a new issue (a reported defect) on a vehicle or equipment. Fleetio may notify the people who watch or are assigned to it. Needs the asset id (fleetio_list_vehicles) and a summary; the report time defaults to now. Does not close, resolve or delete anything. - Add meter entry
fleetio_create_meter_entryWRITE: record an odometer / engine-hour meter reading for a vehicle (primary meter, or the secondary meter with secondary=true). Fleetio rejects a value that breaks the sequence (a reading must not be lower than an earlier one by date); it cannot be deleted from here. The date defaults to now. A new reading can make service reminders due or overdue, and Fleetio may notify their watchers. - Add comment
fleetio_add_commentWRITE: add a comment to an issue, work order, service entry, service reminder, vehicle or part. Fleetio notifies the watchers of that record (and anyone @mentioned in the text). Comments added here cannot be edited or deleted by this server.
Your usefulapi plan · 4
- Usage status (free-tier meter)
fleetio_usage_statusReport the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter. - Request a missing feature
fleetio_request_featureTell usefulapi that the user needs something the Fleetio tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter. - Upgrade to Pro or Pro+
fleetio_upgradeGet a paid plan for Fleetio (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter. - Cancel the Pro subscription
fleetio_cancel_subscriptionCancel the caller's Fleetio Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run fleetio_upgrade later to undo the cancel before the period ends. Does not count against the meter.
FAQ
What can I do with Fleetio in Claude or ChatGPT?
Find vehicles with open work orders. Check service reminders that are due. Sum up fuel spending. Review the service history of a vehicle. Look at issues, faults and failed inspections. Log an issue or meter reading, or add a comment. See what you can do for the details.
Is this an official Fleetio product?
No. usefulapi is an independent service. It is not affiliated with or endorsed by Fleetio. The server calls the Fleetio API with your own Fleetio access, so it sees only the data that your account can see.
Can I connect Fleetio to Claude or ChatGPT?
Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.
What do I need to connect?
The login page asks for your Fleetio API key and Fleetio Account-Token. See Before you connect for where to find them.
Do I put my Fleetio key or an Authorization header in the client config?
No. Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your Fleetio API key and Fleetio Account-Token. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
How do you keep my Fleetio credentials?
The login stores them encrypted in the authorization grant of your connection. The server uses them to call the Fleetio API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in Fleetio.
Can the AI change my Fleetio data?
Yes, if you approve it. 3 of the 44 Fleetio tools can create or change data. The other 41 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.
What does it cost?
The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this Fleetio server only. Cancel any time: your paid plan then runs to the end of the paid period. Run fleetio_usage_status to see how many calls you used.
How do I subscribe or cancel?
Ask the AI to run fleetio_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run fleetio_cancel_subscription. Your paid plan continues to the end of the paid period.
What if a Fleetio tool that I need is missing?
Tell the AI what you wanted to do. It can send the request with fleetio_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.
Which AI clients can I use?
Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.
Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.