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.

22 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.

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).
delete_itemDeletesPermanently delete an item by `workspace_id` and `product_id`.
get_fieldGet one custom field by `field_id`, including its type and options.
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_teamGet details of your airfocus team (organisation).
get_workspaceGet one workspace by `workspace_id`, including its statuses and fields.
get_workspace_by_aliasGet a workspace by its short alias (`product_value`), as seen in airfocus URLs.
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_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`).
search_all_itemsChanges dataSearch items across workspaces by text (`search_query`), optionally limited to `workspace_ids`, assignees or status categories.
search_itemsChanges dataSearch items in a workspace (`workspace_id`) using `filter` and `sort`; set `archived` to include archived items.
search_workspacesChanges dataSearch workspaces (roadmaps, boards) using `filter` and `sort`; set `archived` to include archived ones. Returns workspace IDs.
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.
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 PipMCP 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 PipMCP 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?

PipMCP 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.