MCP App Store
by KeenEthics
GoCodes icon

GoCodes MCP Server for ChatGPT

By GoCodes, Inc.

Overview

This plugin allows you to harness the power of AI while working with your GoCodes Asset & Inventory data. Now you can use AI chat to answer questions like 'Where's my nearest compressor?', 'What tasks do I need to work on today?' and much more. On your smartphone you can now talk to GoCodes using just your voice ChatGPT.

How to connect

  1. ChatGPT: Open the GoCodes listing in the ChatGPT app directory and choose Connect. ChatGPT listing GoCodes exposes 40 tools here.

Tools

activate_asset

ChatGPT
Activate a GoCodes asset tag in the authenticated user's own account: claim an existing, unclaimed printed code (the ID on the QR/barcode label, e.g. 'ABCD-1234') and create a new company-owned asset for it, optionally with an initial type, serial number, model, reward and description. Fails with a clear message if the code doesn't exist, is already activated in this account, or is activated by another account (which must delete it first to release the code). Other fields can be set afterwards with update_asset. Requires the Administrator, GroupAdministrator, or AssetManager role. The caller's own authorized account data.

assign_task

ChatGPT
Assign a task in the authenticated user's own GoCodes account to a user, by the task's numeric ID and the assignee's email. IMPORTANT: omitting 'customerEmail' (or passing an empty string) UNASSIGNS the task — pass an email to assign it. This changes only the assignee; no other task field is touched. Requires the Tasks feature and a role that permits assigning (Administrator, GroupAdministrator, AssetManager, or AssetAssigner). The caller's own authorized account data.

create_task

ChatGPT
Create a new task on a company-owned asset in the authenticated user's own GoCodes account. Only 'assetId' and 'name' are required; every other field is optional and is left unset when omitted. If 'taskStatusId' is omitted the task starts in the account's initial status (see list_task_statuses). Set 'customerEmail' to assign the task to a user at creation time. Requires the Tasks feature and a role that permits creating tasks (Administrator, GroupAdministrator, or AssetManager). Returns the new task's numeric ID. The caller's own authorized account data.

delete_asset

ChatGPT
Permanently delete a company-owned asset from the authenticated user's own GoCodes account and release its tag code so it can be activated again (the GoCodes app labels this action 'Deactivate'). It is not a reversible disable. Re-activating the same code with activate_asset creates a NEW, blank asset — the deleted asset's fields are not restored, and undo_asset_changes cannot bring it back. The audit history keyed by the code survives. To take an asset out of service while keeping its data, set its status with update_asset instead. As a safeguard, confirmAssetId must repeat assetId exactly; confirm with the user before calling. On success the result includes a snapshot of the asset's details, read immediately before the delete request. Requires the Administrator, GroupAdministrator, or AssetManager role, and only works on the caller's own company's assets — including for Administrators, who can view other companies' assets but cannot delete them. The caller's own authorized account data.

get_asset_assignment_history

ChatGPT
Get the check-out / assignment history for a company-owned asset in the authenticated user's own GoCodes account: who had it, when, the return date, and how long it was checked out. Authorized account data.

get_asset_change_history

ChatGPT
Get the full audit/change log for a company-owned asset in the authenticated user's own GoCodes account: every recorded change with the date, the user who made it, and a description of what changed. Authorized account data.

get_asset_details

ChatGPT
Get the full detail record for a single company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID (the code on the QR/barcode label, e.g. 'ABCD-1234'). Authorized account data.

get_asset_location

ChatGPT
Get the last recorded location of a company-owned asset (equipment) in the authenticated user's own GoCodes account, by its GoCodes asset ID. Returns the asset's last known GPS coordinates and the date recorded. This is equipment-location data the caller is authorized to access; it does not track people.

get_asset_picture

ChatGPT
Fetch the photo for a company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID. Returns the image so it can be displayed inline. Returns a text message if the asset has no picture on file. Authorized account data.

get_assets_batch

ChatGPT
Get full detail records for multiple company-owned assets in the authenticated user's own GoCodes account, by their GoCodes asset IDs. More efficient than calling get_asset_details repeatedly. Authorized account data.

get_company_settings

ChatGPT
Get a GoCodes company account's name and feature toggles (inventory, inventory alerts, assignment reminders, service notifications, public documentation URL, offline mode, advanced permissions, Tasks, Kits, Attachments, Teletrac GPS), plus checkOutVisibility: which of the company's custom fields are shown on the check-out form, keyed customField1..10 (the same shape get_custom_field_schema returns for the caller's own account). Whether the account itself is enabled is a separate tool, get_company_status. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

get_company_status

ChatGPT
Check whether a GoCodes company account itself is enabled (a disabled account locks out every user in it). Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

get_custom_field_schema

ChatGPT
Get the authenticated user's own GoCodes account custom-field configuration: the display names assigned to each field (including the custom1–custom10 slots), the allowed/picklist values configured for them, and which custom fields are shown on the check-out form. Use this to interpret the customValue1..10 and renamed fields on assets. Authorized account data.

get_kit_contents

ChatGPT
List the company-owned assets contained inside a kit in the authenticated user's own GoCodes account, identified by the kit-parent asset's GoCodes asset ID. Requires the Kits feature to be enabled. Authorized account data.

get_task_details

ChatGPT
Get the full detail record for a single task in the authenticated user's own GoCodes account, by its numeric task ID, including name, description, due date, status, assignee, and attachment metadata. Authorized account data.

get_tasks_for_asset

ChatGPT
Get all tasks assigned to a specific company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID. Authorized account data.

get_user_profile

ChatGPT
Get a GoCodes personal profile: name, alternate emails, and work/mobile phone numbers. Omit targetEmail to view the caller's own profile; supply it to view a DIFFERENT person's profile instead. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

list_asset_attachments

ChatGPT
List the attachment metadata (filename, size, upload date, uploader) on a company-owned asset in the authenticated user's own GoCodes account. Requires the Attachments feature to be enabled on the account. Authorized account data.

list_asset_types

ChatGPT
List the asset types defined for the authenticated user's own GoCodes account (id and name) — the taxonomy used to categorize the caller's company assets. Authorized account data.

list_assets_by_location

ChatGPT
List the authenticated user's own company-owned assets at a given home location (case-insensitive substring match). If 'location' is omitted or empty, instead returns the distinct locations with an asset count for each. Equipment locations within the caller's authorized GoCodes account, not people tracking.

list_assignees

ChatGPT
List the assignees configured in the authenticated user's own GoCodes account (name and email) — the people the caller's assets can be checked out to and tasks assigned to (GoCodes calls them 'customers'). This is the caller's own account roster, which they are authorized to access.

list_checked_out_assets

ChatGPT
List the authenticated user's own company-owned assets that are currently checked out (assigned to someone/somewhere), including who they are assigned to and their expected return date. Authorized account data.

list_company_accounts

ChatGPT
List GoCodes company accounts (CustomerGroup): id, name, membership level, and whether the account is disabled. This is how an Administrator discovers a company's targetCustomerGroupId for use with the Account tools below (get_company_settings, update_company_settings, get_company_status, set_company_enabled), each of which requires that id. Omit searchText to list every company account in the system; supply it to filter to names containing that text (case-insensitive substring match). Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

list_kits

ChatGPT
List all kit-parent assets in the authenticated user's own GoCodes account (assets that group other assets together). Requires the Kits feature to be enabled. Authorized account data.

list_my_tasks

ChatGPT
List the tasks assigned to the current authenticated user (the caller) in their own GoCodes account, including due dates, status, and the asset each task is on. Authorized account data.

list_overdue_assets

ChatGPT
List the authenticated user's own checked-out company assets whose expected return date has passed (overdue), most overdue first, with the number of days overdue. Authorized account data.

list_service_due_assets

ChatGPT
List the authenticated user's own company assets whose next scheduled service date is due. By default returns assets due on or before today; pass 'withinDays' to also include service coming up within that many days. Negative 'daysUntilDue' means already overdue. Authorized account data.

list_task_attachments

ChatGPT
List the attachment metadata (filename, size, upload date, uploader) on a task in the authenticated user's own GoCodes account. Requires the Tasks and Attachments features to be enabled on the account. Authorized account data.

list_task_statuses

ChatGPT
List the task statuses defined for the authenticated user's own GoCodes account (id and name), e.g. for interpreting the taskStatusId on a task. Authorized account data.

list_tasks

ChatGPT
List all tasks in the authenticated user's own GoCodes account, including task details, due dates, assigned assets, and customer information. Returns up to 'limit' tasks. Authorized account data.

list_upcoming_due_dates

ChatGPT
List upcoming due dates in the authenticated user's own GoCodes account for a date range: asset return dates, scheduled service dates, asset end-of-life dates, and task due dates. Dates are yyyy-MM-dd. Defaults to the next 30 days from today. Authorized account data.

search_assets

ChatGPT
Search the authenticated user's own GoCodes account inventory of company-owned assets, with free-text keyword search, structured field filters, sorting and paging (the same search the GoCodes web app's asset list uses). 'keyword' matches asset ID, type, serial number, model, description, group, location, assigned-to, status, custom fields, etc.; several space-separated words must ALL match, and a list of 8-character asset IDs returns exactly those assets. 'filters' narrow by specific fields, e.g. [{field:'status',operator:'eq',value:'Active'}, {field:'nextServiceDate',operator:'lte',value:'2024-12-31'}]. Filterable/sortable fields: assetId, otherAssetId, assetTagType, assetTypeId, assetTypeName, assetTypeDisplay, otherType, serialNumber, model, reward, description, subType, group, purchaseDate, originalCost, salvageValue, lifespanInYears, currentValue, warrantyTerms, lastServiceDate, lastServiceNote, nextServiceDate, homeLocation, assignedTo, checkedOut, returnDate, status, quantity, quantityMinimum, documentationUrl, hasPicture, locationDate, latitude, longitude, lastUpdated, customValue1..customValue10 (use get_custom_field_schema for their labels), lastChangedBy, kit, kitAssetId. Fields hidden from the caller by the account's per-user field permissions cannot be used to filter or sort. Text comparisons are case-insensitive. Results are paged: the response includes 'total' (all matches), 'hasMore' and 'nextPage' — request the next page to continue. All results are account data the caller is authorized to access.

set_company_enabled

ChatGPT
Enable or disable a GoCodes company account. CAUTION: setting this to false locks every user in that company out of GoCodes until it is re-enabled — confirm this is really intended before calling; recommend calling get_company_status with the same id first to confirm you've resolved the intended company. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

summarize_inventory

ChatGPT
Summarize the authenticated user's own GoCodes account inventory. With no 'assignee', gives an account-wide summary (totals, value, breakdowns by type/status/location, and top assignees). With an 'assignee' (matches the asset's assigned-to value, case-insensitive substring), summarizes just the assets assigned to that person. Authorized account data.

undo_asset_changes

ChatGPT
Undo the caller's own recent field edits to company-owned assets, rolling them back to their state before those changes, using the change log written by update_asset. It cannot bring back an asset removed with delete_asset. By default (apply=false) it only PREVIEWS what would be undone and writes nothing; call again with apply=true to actually perform the undo. With no dates it targets today's changes in UTC — the 'current session'; pass fromDate/toDate (ISO 8601, treated as UTC; a bare date covers the whole UTC day) to target a date range. Optionally restrict to one assetId. Each asset is rolled back to its earliest recorded state within the window (undoing every change in that window). Only changes made by the current user are considered. Undos are themselves logged, so they can be undone too. The caller's own authorized account data.

update_asset

ChatGPT
Update the editable fields of a single company-owned asset in the authenticated user's own GoCodes account, identified by its GoCodes asset ID. Only the parameters you supply are changed; every other field is preserved. Each value you provide REPLACES that field wholesale — text fields are never appended to the existing value, so to add to a note you must pass the full new text yourself; omit a field to leave it unchanged. Internally the tool re-reads the asset's current values and re-submits the COMPLETE record with your changes merged in, because the GoCodes update API is a full replacement — any field left out of the request would be wiped. To clear a text field pass an empty string. Numeric/date fields you omit keep their current value. Changing 'checkedOut'/'assignedTo' records a check-out/check-in in the assignment history. Requires an account role that permits editing (Administrator, Customer, GroupAdministrator, AssetManager, or AssetAssigner); the caller's own authorized account data.

update_company_settings

ChatGPT
Update a GoCodes company account's name, feature toggles, and/or which custom fields are shown on the check-out form (showCustomField1..10OnCheckOut, the writable counterpart of the checkOutVisibility that get_company_settings reports). Only the parameters you supply are changed — each is a single independent update, so omitted settings are never touched (unlike update_asset, there is no full-record replacement risk here). Enabling inventory alerts also enables inventory (a server-side rule, not replicated here). Whether the account itself is enabled is a separate tool, set_company_enabled. CAUTION: toggling enableAdvancedPermissions changes the permission model for every user in the company, not just the caller. Disabling enableTasks/enableKits/enableAttachments/enableTeletrac also disables the corresponding task/kit/attachment/location MCP tools for this account. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id, and recommend calling get_company_settings with the same id first to confirm you've resolved the intended company. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

update_task

ChatGPT
Update an existing task in the authenticated user's own GoCodes account, by its numeric task ID. Only the parameters you supply are changed; every other field is preserved. Each value you provide REPLACES that field wholesale — text fields are never appended to the existing value; pass an empty string to clear a text field, or omit a field to leave it unchanged. Internally the tool re-reads the task's current values and re-submits the COMPLETE record with your changes merged in, because the GoCodes update API is a full replacement — any field left out of the request would be wiped. To change ONLY the status use update_task_status, and to change ONLY the assignee use assign_task. Requires the Tasks feature and a role that permits editing tasks (Administrator, GroupAdministrator, or AssetManager). The caller's own authorized account data.

update_task_status

ChatGPT
Change only the status of a task in the authenticated user's own GoCodes account, by its numeric task ID. Use list_task_statuses to get the valid status IDs for the account. This is the preferred way to change a task's status: it touches only the status field, so no other task data can be affected. Requires the Tasks feature and a role that permits updating tasks (Administrator, GroupAdministrator, AssetManager, or AssetAssigner). The caller's own authorized account data.

update_user_profile

ChatGPT
Update fields of a GoCodes personal profile. Only the parameters you supply are changed; every other field is preserved (internally the tool re-reads the current profile and re-submits it with your changes merged in). Empty string clears a text field; omit a field to leave it unchanged. Omit targetEmail to update the caller's own profile; supply it to update a DIFFERENT person's profile instead — recommend calling get_user_profile with the same targetEmail first to confirm you've resolved the intended person. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/gocodes"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/gocodes)