Read Fleetio vehicles, work orders, service, issues, inspections, fuel, parts; log issues, meters. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Team and Enterprise: an Owner adds the connector for the organization first.
Run this command, then run /mcp in Claude Code to log in:
Add to Cursor or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"fleetio": {
"url": "https://fleetio.usefulapi.io/mcp"
}
}
}Add to VS Code or add this to .vscode/mcp.json:
{
"servers": {
"fleetio": {
"type": "http",
"url": "https://fleetio.usefulapi.io/mcp"
}
}
}Other MCP clients (Windsurf, Cline, Zed and more): add the URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser. Do not add an Authorization header: see 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.
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.
| Tool | Type | What it does |
|---|---|---|
fleetio_list_accounts | read | List accounts The 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. GET /accounts. |
fleetio_list_vehicles | read | List vehicles List 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). |
fleetio_list_vehicle_meter_entries | read | List a vehicle's meter entries List 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). |
fleetio_list_meter_entries | read | List meter entries List 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). |
fleetio_list_vehicle_assignments | read | List vehicle assignments List 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). |
fleetio_list_equipment | read | List equipment List equipment (non-vehicle assets such as trailers and tools). GET /equipment. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_work_orders | read | List work orders List 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). |
fleetio_list_service_entries | read | List service entries List 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). |
fleetio_list_vehicle_service_entries | read | List a vehicle's service entries List the service entries of ONE vehicle. GET /vehicles/{id}/service_entries. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_service_reminders | read | List service reminders List 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). |
fleetio_list_issues | read | List issues List 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). |
fleetio_list_faults | read | List faults List 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). |
fleetio_list_inspection_forms | read | List inspection forms List 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). |
fleetio_list_submitted_inspections | read | List submitted inspections List 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). |
fleetio_list_fuel_entries | read | List fuel entries List 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). |
fleetio_list_parts | read | List parts List 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). |
fleetio_list_part_stock | read | List part stock by location List 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). |
fleetio_list_contacts | read | List contacts List 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). |
fleetio_list_vendors | read | List vendors List 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). |
fleetio_list_vehicle_renewal_reminders | read | List vehicle renewal reminders List 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). |
fleetio_list_comments | read | List comments List 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). |
fleetio_list_vehicle_statuses | read | List vehicle statuses Lookup: 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). |
fleetio_list_vehicle_types | read | List vehicle types Lookup: the vehicle types (Car, Truck, Van, ...) and their ids. GET /vehicle_types. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_work_order_statuses | read | List work order statuses Lookup: the work order statuses (Open, In Progress, Completed, ...). GET /work_order_statuses. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_issue_priorities | read | List issue priorities Lookup: 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). |
fleetio_list_groups | read | List groups Lookup: the groups (locations/departments) and their ids. GET /groups. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_labels | read | List labels Lookup: 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). |
fleetio_list_service_tasks | read | List service tasks Lookup: the service tasks (Oil Change, Tire Rotation, ...) and their ids. GET /service_tasks. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_list_places | read | List places List places (geofences/locations) with address, coordinates and radius. GET /places. Returns one page (keyset paging: pass next_cursor as start_cursor). |
fleetio_get_vehicle | read | Get vehicle One vehicle with full detail: status, type, group, meters, VIN, make/model/year, license plate, dates. GET /vehicles/{id}. |
fleetio_get_equipment | read | Get equipment One equipment record with full detail. GET /equipment/{id}. |
fleetio_get_work_order | read | Get work order One work order with full detail (status, vendor, technician, dates, totals). GET /work_orders/{id}. |
fleetio_get_service_entry | read | Get service entry One service entry with full detail (vehicle, vendor, notes, meter readings, totals). GET /service_entries/{id}. |
fleetio_get_part | read | Get part One part with full detail (number, manufacturer, category, costs). GET /parts/{id}. |
fleetio_get_contact | read | Get contact One contact (driver/technician/employee). Birth date and driver-licence data are never returned. GET /contacts/{id}. |
fleetio_get_vendor | read | Get vendor One vendor with full detail. GET /vendors/{id}. |
fleetio_get_submitted_inspection | read | Get submitted inspection One submitted inspection with every item's result (pass/fail/remarks), the vehicle, driver and any resulting work order. GET /submitted_inspection_forms/{id}. |
fleetio_get_inspection_form | read | Get inspection form One inspection form template with its items. GET /inspection_forms/{id}. |
fleetio_get_issue | read | Get issue One issue with full detail (state, priority, asset, reporter, due date, resolution). Optionally include comments, labels, the asset, custom fields, documents or images. GET /issues/{id}. |
fleetio_list_work_order_line_items | read | List work order line items The line items (labor, parts, fees) of ONE work order. GET /work_orders/{id}/work_order_line_items. |
fleetio_list_service_entry_line_items | read | List service entry line items The line items (tasks, parts, labor) of ONE service entry. GET /service_entries/{id}/service_entry_line_items. |
fleetio_create_issue | write | Create issue WRITE: 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. POST /issues. |
fleetio_create_meter_entry | write | Add meter entry WRITE: 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. POST /meter_entries. |
fleetio_add_comment | write | Add comment WRITE: 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. POST /comments. |
fleetio_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
fleetio_request_feature | Request a missing feature Tell 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. | |
fleetio_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Fleetio tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Does not count against the meter. | |
fleetio_cancel_subscription | Cancel the Pro subscription Cancel the caller's Fleetio Pro subscription at the end of the paid period (no refund for the current period; unlimited calls continue 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. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper account | $9/mo · $90/yr | Unlimited |
Pro covers this Fleetio server only. Subscribe with fleetio_upgrade (it returns a Stripe Checkout link). Cancel any time with fleetio_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running fleetio_upgrade before then undoes the cancel. Or write to [email protected].
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.
The login page asks for your Fleetio API key and Fleetio Account-Token. See Before you connect for where to find them.
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.
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.
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.
The Free plan gives 100 tool calls / month. Pro costs $9/mo or $90/yr, with unlimited tool calls, for this Fleetio server only. Run fleetio_usage_status to see how many calls you used.
Ask the AI to run fleetio_upgrade: it returns a Stripe Checkout link. To cancel, run fleetio_cancel_subscription. Pro continues to the end of the paid period.
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.
Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, 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.