Integration · Projects & tasks

Connect Claude & ChatGPT to airfocus

Ask your AI what is on a roadmap, which items are assigned to you, or to add a new item to an airfocus workspace. It can search items and workspaces, create and update items with status, assignees and custom fields, link parent and child items, move items between workspaces, and read comments and attachments. You can check and change priorities from a chat.

Connect airfocus free

Free plan, no credit card. Takes about a minute.

Try asking

“Find everything about SSO across our workspaces.”
The AI searches items in all workspaces by text and returns the matches.
“Add an item called Bulk export to the Product roadmap, assigned to Maria.”
It finds the workspace and Maria's user ID and creates the item with name, assignee and description.
“Set the status of Mobile app redesign to In progress.”
It reads the workspace's statuses and updates the item.

What your AI can do

Items

Search items by text or filter, read them with status, fields and assignees, and create, update, move or delete them.

Workspaces and fields

Search workspaces, read their statuses and fields, look up custom fields and find users for assignments.

Relations and activity

Link parent and child items, list item links, and read comments and attachments in a workspace.

“Make Checkout v2 a child of the Payments item.”
It looks up both items and creates the parent and child relation.
“What have people commented on the Dark mode item?”
It lists the comments on that item.
“Move these three items from the Roadmap workspace to Backlog.”
It moves the items from one workspace to the other.

123 tools for airfocus

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

approve_toVisible to othersApprove a to. Has effects visible outside this system.
attach_groupChanges dataAssign a group. API summary: Assign workspace to group.
attach_productChanges dataLink a product. API summary: Create a new item-link-type.
attach_workspaceChanges dataAttach a workspace. API summary: Link team-fields to workspaces.
create_a_new_item_linkChanges dataCreate a new product for a workspace. Required: from item id, from order, to item id, to order or type id. Search products first to avoid duplicates. API summary: Create a new item-link.
create_api_keyChanges dataCreate a new api key. Required: name or scopes.
create_change_passwordDeletesCreate a new change password. Required: new password or old password. Destructive action; may require approval.
create_deleteVisible to othersCreate a new delete. Has effects visible outside this system. API summary: Delete multiple fields.
create_fieldChanges dataCreate a new field. Required: body. Search fields first to avoid duplicates. API summary: Install a new field.
create_groupChanges dataCreate a new group. Required: name. Search groups first to avoid duplicates. API summary: Create a new workspace group.
create_group_permissionDeletesCreate a new permission for a group. Required: permissions or user group permissions. Destructive action; may require approval. API summary: Update workspace-group permissions.
create_inbox_counterChanges dataCreate a new counter for a inbox. Required: archived or count assigned. API summary: Retrieve counters of items in each tab of the view.
create_itemChanges dataCreate an item in a workspace (`workspace_id`) with `name`, optional `status_id`, `assignee_user_ids`, custom `fields` (keyed by field ID) and `description`.
create_item_relationChanges dataMake one item the child of another: `parent_id` and `child_id` (item IDs).
create_listChanges dataCreate a new list. API summary: Retrieve multiple item-link-types by their IDs.
create_productChanges dataCreate a new product. Required: properties or query. Search products first to avoid duplicates.
create_product_list_partial_workspacesChanges dataCreate a new product. Required: ids or properties. Search products first to avoid duplicates. API summary: Retrieve multiple workspaces by their IDs with optional partial embed.
create_reorderChanges dataCreate a new reorder. Required: field ids or workspace id. API summary: Reorder fields.
create_reset_colorChanges dataCreate a new reset color. API summary: Reset colors of all items in the specified workspace.
create_settingChanges dataCreate a new setting. Required: settings. API summary: Update notification settings of a user.
create_unwatchChanges dataCreate a new unwatch. API summary: Remove watching status of the current user for the specified items.
create_userVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with item-link-types.
create_user_bulk_commentsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with comments.
create_user_bulk_item_attachmentsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with attachments.
create_user_bulk_item_linksVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with item-links.
create_user_bulk_item_relationsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with item-relations.
create_user_bulk_itemsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with items.
create_user_bulk_status_presetsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with status-presets.
create_user_bulk_workspace_groupsVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with workspace groups.
create_user_bulk_workspacesVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Perform multiple operations with workspaces.
create_user_change_user_disabledChanges dataCreate a new user. Required: disabled or user id. Search users first to avoid duplicates.
create_user_change_user_roleDeletesCreate a new user. Required: role or user id. Search users first to avoid duplicates. Destructive action; may require approval.
create_user_create_user_inviteVisible to othersCreate a new user. Required: user id. Search users first to avoid duplicates. Has effects visible outside this system.
create_user_kick_userChanges dataCreate a new user. Required: user id. Search users first to avoid duplicates.
create_workspaceChanges dataCreate a new workspace. Required: description, last activity, name or order. Search workspaces first to avoid duplicates.
create_workspace_documentChanges dataCreate a new document for a workspace. Required: content type, item id, name or uri. Search documents first to avoid duplicates. API summary: Create a new attachment.
create_workspace_messageChanges dataCreate a new message for a workspace. Required: content or item id. Search messages first to avoid duplicates. API summary: Create a new comment.
create_workspace_permissionDeletesCreate a new permission for a workspace. Required: permissions or user group permissions. Destructive action; may require approval. API summary: Update workspace permissions.
create_workspace_statusChanges dataCreate a new status for a workspace. Required: replacements or statuses. API summary: Configure workspace statuses.
delete_an_existing_item_linkDeletesPermanently delete a product by item link id. Destructive action; may require approval. API summary: Delete an existing item-link.
delete_an_existing_item_relationDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete an existing item-relation.
delete_api_keyDeletesPermanently delete a api key by api key id. Destructive action; may require approval.
delete_fieldDeletesPermanently delete a field by field id. Destructive action; may require approval. API summary: Delete field.
delete_groupDeletesPermanently delete a group by workspace group id. Destructive action; may require approval. API summary: Delete an existing workspace group.
delete_itemDeletesPermanently delete an item by `workspace_id` and `product_id`.
delete_message_reactionDeletesPermanently delete a reaction by emoji code. Destructive action; may require approval. API summary: Remove a reaction from the specified comment.
delete_productDeletesPermanently delete a product by item link type id. Destructive action; may require approval. API summary: Delete an existing item-link-type.
delete_status_presetDeletesPermanently delete a status preset by status preset id. Destructive action; may require approval. API summary: Delete an existing status-preset.
delete_workspaceDeletesPermanently delete a workspace by workspace id. Destructive action; may require approval. API summary: Delete an existing workspace.
delete_workspace_documentDeletesPermanently delete a document by item attachment id. Destructive action; may require approval. API summary: Delete an existing attachment.
delete_workspace_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete an existing comment.
detach_workspaceChanges dataUnlink a workspace. API summary: Unlink team-fields from workspaces.
export_templatesChanges dataExport templates. API summary: Exports a template for given workspaces.
get_fieldGet one custom field by `field_id`, including its type and options.
get_groupGet one group by workspace group id. API summary: Retrieve a single workspace group by its ID.
get_itemGet one item by `workspace_id` and `product_id` (item ID), with its status, fields, assignees and description.
get_item_by_aliasGet an item by its alias (`product_value`), e.g. the short key shown in airfocus.
get_my_profileGet the connected airfocus user's own profile. Use to confirm which account you are working in.
get_preset_statusChanges dataGet the current status of a preset. API summary: Create a new status-preset.
get_productGet one product by item link type id. API summary: Retrieve a single item-link-type by its ID.
get_status_presetGet one status preset by status preset id. API summary: Retrieve a single status-preset by its ID.
get_teamGet details of your airfocus team (organisation).
get_workspaceGet one workspace by `workspace_id`, including its statuses and fields.
get_workspace_2Get one workspace. API summary: Count workspaces in the current team.
get_workspace_by_aliasGet a workspace by its short alias (`product_value`), as seen in airfocus URLs.
get_workspace_documentGet one document for a workspace by item attachment id. API summary: Retrieve a single attachment by its ID.
get_workspace_messageGet one message for a workspace by message id. API summary: Retrieve a single comment by its ID.
list_ai_actorsList ai actors. API summary: List all AI actors for the caller's team.
list_api_keysList api keys.
list_client_settingsList client settings. Optional filters: path.
list_fieldsChanges dataList custom fields, optionally for given `workspace_ids`. Use to find field IDs for item `fields`.
list_item_attachmentsChanges dataList attachments in a workspace (`workspace_id`), optionally for one `item_id`.
list_item_commentsChanges dataList comments in a workspace (`workspace_id`), optionally for one `item_id`.
list_item_linksChanges dataList links between items in a workspace (`workspace_id`), optionally for given `item_ids`.
list_item_relationsChanges dataList parent/child relations between items, narrowed with `filter`.
list_maintenance_windowsList maintenance windows. Optional filters: upcoming days.
list_productsList products. API summary: List all available field types.
list_products_retrieve_item_link_type_workspace_countList products for a product.
list_settingsList settings. API summary: Get notification settings of a user.
list_templatesList templates. Results are paginated.
list_usersList users in your airfocus team, optionally filtered by `query`. Use to find a user ID for assignments.
move_itemsChanges dataMove items (`items`) from one workspace (`source_workspace_id`) to another (`target_workspace_id`).
patch_an_existing_item_linkChanges dataUpdate an existing product identified by item link id. Only the fields you pass are changed. API summary: Patch an existing item-link.
patch_an_existing_item_relationChanges dataUpdate an existing product identified by product id. Only the fields you pass are changed. API summary: Patch an existing item-relation.
retrieve_a_single_item_link_by_its_idGet one product for a workspace by item link id. API summary: Retrieve a single item-link by its ID.
retrieve_a_single_item_relation_by_its_idGet one product by product id. API summary: Retrieve a single item-relation by its ID.
retrieve_items_from_any_workspace_by_specified_idsChanges dataCreate a new list. API summary: Retrieve items from any workspace by specified IDs.
retrieve_items_used_for_dashboards_and_analyticsChanges dataCreate a new product. Search products first to avoid duplicates. API summary: Retrieve items used for dashboards and analytics.
retrieve_multiple_attachments_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple attachments by their IDs.
retrieve_multiple_comments_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple comments by their IDs.
retrieve_multiple_item_links_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple item-links by their IDs.
retrieve_multiple_item_relations_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple item-relations by their IDs.
retrieve_multiple_items_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple items by their IDs.
retrieve_multiple_status_presets_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple status-presets by their IDs.
retrieve_multiple_workspace_groups_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple workspace groups by their IDs.
retrieve_multiple_workspaces_by_their_idsChanges dataCreate a new list. API summary: Retrieve multiple workspaces by their IDs.
retrieve_or_search_partial_itemsChanges dataCreate a new product. Required: properties. Search products first to avoid duplicates. API summary: Retrieve or search partial items.
search_all_itemsChanges dataSearch items across workspaces by text (`search_query`), optionally limited to `workspace_ids`, assignees or status categories.
search_groupsChanges dataSearch groups. Use this to find existing groups before creating a new group. API summary: Retrieve or search workspace groups.
search_itemsChanges dataSearch items in a workspace (`workspace_id`) using `filter` and `sort`; set `archived` to include archived items.
search_productsChanges dataSearch products. Use this to find existing products before creating a new product. API summary: Retrieve or search item-link-types.
search_status_presetsChanges dataSearch status presets. Use this to find existing status presets before creating a new status preset. API summary: Retrieve or search status-presets.
search_workspacesChanges dataSearch workspaces (roadmaps, boards) using `filter` and `sort`; set `archived` to include archived ones. Returns workspace IDs.
send_userVisible to othersSend a user. Has effects visible outside this system.
send_user_send_bulk_user_invitesDeletesSend a user. Destructive action; may require approval.
submit_productVisible to othersCopy a product. Has effects visible outside this system. API summary: Copy specified items.
submit_userVisible to othersResend a user. Has effects visible outside this system.
submit_workspaceVisible to othersDuplicate a workspace (workspace id). Has effects visible outside this system. API summary: Duplicate workspace with all its items and apps.
update_applyChanges dataUpdate an existing apply identified by template id. API summary: Install template.
update_client_settingsVisible to othersUpdate an existing client setting. Has effects visible outside this system.
update_fieldChanges dataUpdate an existing field identified by field id. API summary: Reconfigure field.
update_flagsVisible to othersUpdate an existing flag. Only the fields you pass are changed. Has effects visible outside this system.
update_groupChanges dataUpdate an existing group identified by workspace group id. Only the fields you pass are changed. API summary: Patch an existing workspace group.
update_itemChanges dataUpdate an item (`workspace_id`, `product_id`) with a JSON Patch array in `items`, e.g. [{"op":"replace","path":"/name","value":"New name"}]. Use the field names returned by get_item.
update_message_reactionChanges dataUpdate an existing reaction identified by emoji code. API summary: Add a reaction to the specified comment.
update_productChanges dataUpdate an existing product identified by item link type id. Only the fields you pass are changed. API summary: Patch an existing item-link-type.
update_profilesVisible to othersUpdate an existing profile. Has effects visible outside this system.
update_status_presetChanges dataUpdate an existing status preset identified by status preset id. Only the fields you pass are changed. API summary: Patch an existing status-preset.
update_status_preset_statusesVisible to othersUpdate an existing status identified by status preset id. Has effects visible outside this system. API summary: Update statuses of a status preset.
update_workspaceChanges dataUpdate an existing workspace identified by workspace id. Only the fields you pass are changed. API summary: Patch an existing workspace.
update_workspace_documentChanges dataUpdate an existing document identified by item attachment id. Only the fields you pass are changed. API summary: Patch an existing attachment.
update_workspace_messageChanges dataUpdate an existing message identified by message id. Only the fields you pass are changed. API summary: Patch an existing comment.
watch_itemsChanges dataStart watching items in a workspace to get notified of changes.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose airfocus from the app list.
2
Paste your key
Enter your airfocus app host (app.airfocus.com for EU accounts, app.us.airfocus.com for US accounts) and an API key. In airfocus, click your name in the bottom-left corner, go to Account settings > API keys and click Add API key. Give it a name, select the scopes you need, click Create and copy the key. It is shown only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in airfocus?

The AI can search and read items, workspaces, custom fields, users, item relations, links, comments and attachments, and read your profile and team. It can create and update items, make one item the child of another, move items between workspaces, watch items and delete an item.

Does the AI see my airfocus API key?

No. Your airfocus API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with searching and reading only. Deleting an item is permanent and can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan, and you do not need a credit card to start. Paid plans bill per completed task. You also need your own airfocus account.

Which app host should I use?

Use app.airfocus.com if your airfocus account is in the EU, and app.us.airfocus.com if it is in the US. You enter the host together with your API key.