Integration · Projects & tasks

Connect Claude & ChatGPT to Workast

Ask your AI what is due this week, to add a task to a space and assign it, or to mark a milestone as done in Workast. It can create, update, assign, tag, comment on, complete and reopen tasks, add subtasks, create and update spaces and milestones, and search tasks across your team. Task questions get answered without switching views.

Connect Workast free

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

Try asking

“What is assigned to me and due this week?”
The AI finds your user and lists your tasks filtered by assignee and due date.
“Add a task to the Marketing space: Draft October newsletter, due Friday, assigned to Emma.”
It finds the space and Emma's user ID and creates the task with the due date and assignee.
“Break the newsletter task into three subtasks.”
It creates three subtasks under the task.

What your AI can do

Tasks

Create, update, assign, tag, comment on, complete, reopen and delete tasks, and add subtasks.

Spaces and milestones

Create and update spaces, list space notes, and create, update and complete milestones.

Search and people

Search tasks by text, assignee, status and due date, and list users and tags.

“Comment on task 482: Waiting for final images from the designer.”
It finds the task by its short ID and adds the comment.
“Mark the website launch milestone as done.”
It finds the milestone and marks it as done.
“Which tasks in the Sales space are still open?”
It lists the space's tasks filtered by status.

146 tools for Workast

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

add_task_commentChanges dataAdd a comment to a task by `task_id`: set `type` to comment and the text in `value` (Markdown allowed), optionally `mentions`.
add_task_tagsChanges dataAdd tags to a task by `task_id`.
archive_listVisible to othersArchive a list (list id). Has effects visible outside this system. API summary: Archive a space.
archive_userVisible to othersDeactivate a user (user id). Has effects visible outside this system.
archive_workflowVisible to othersDeactivate a workflow (workflow id). Has effects visible outside this system.
assign_taskChanges dataAssign users (`users`, a list of user IDs) to a task by `task_id`.
complete_milestoneChanges dataMark a milestone as done by `milestone_id`.
complete_taskChanges dataMark a task as done by `task_id`.
create_a_space_activityChanges dataCreate a new task for a list. Search tasks first to avoid duplicates. API summary: Create a space activity.
create_activity_reactionChanges dataCreate a new reaction for a activity. Required: emoji. API summary: Add a reaction.
create_bulkVisible to othersCreate a new bulk. Required: items. Has effects visible outside this system. API summary: Create multiple tasks at once.
create_fieldChanges dataCreate a new field. Required: name or type. API summary: Create a new custom field in the team.
create_inviteVisible to othersCreate a new invite. Required: name, email or role. Has effects visible outside this system. API summary: Invite a new user to the Workast team.
create_joinChanges dataCreate a new join. API summary: Join a space.
create_list_documentChanges dataCreate a new document for a list. Search documents first to avoid duplicates. API summary: Create a space attachment.
create_list_messageChanges dataCreate a new message for a list. Search messages first to avoid duplicates. API summary: Create a Note.
create_list_moveChanges dataCreate a new move for a list. Required: tasks or target. API summary: Move tasks between spaces.
create_list_participantChanges dataCreate a new participant for a list. API summary: Add participants to a space.
create_meetingChanges dataCreate a new meeting. Required: list id or event. API summary: Create a meeting from a calendar event.
create_milestoneChanges dataCreate a milestone with `name` in a space (`list_id`), optionally start and end dates.
create_milestone_undoneChanges dataCreate a new undone for a milestone. API summary: Undo milestone.
create_notification_readChanges dataCreate a new read for a notification. API summary: Mark notification as read.
create_notification_unreadChanges dataCreate a new unread for a notification. API summary: Mark notification as unread.
create_readChanges dataCreate a new read. API summary: Mark task notifications as read.
create_read_mark_unread_notifications_as_readChanges dataCreate a new read. API summary: Mark all unread notifications as read.
create_requestChanges dataCreate a new request. API summary: Request access to a space.
create_searchChanges dataCreate a new search. Search searches first to avoid duplicates. API summary: Create a Search.
create_search_homeChanges dataCreate a new home for a search. Search homes first to avoid duplicates. API summary: Add search to the home screen.
create_search_userChanges dataCreate a new user for a search. Search users first to avoid duplicates. API summary: Share Search with users.
create_spaceChanges dataCreate a space with a `name`, optionally description, type, privacy and participants.
create_subscribeChanges dataCreate a new subscribe. API summary: Subscribe to a specific notifications channel.
create_subtaskChanges dataCreate a subtask with `text` under a task by `task_id`, optionally due date and assignees.
create_tagChanges dataCreate a new tag. API summary: Creates a new tag.
create_taskChanges dataCreate a task with `text` in a space (`list_id`), optionally description, due date, start date, repeat and assignees.
create_task_2Changes dataCreate a new task for a task. Search tasks first to avoid duplicates. API summary: Convert subtask to task.
create_task_convert_to_subtaskChanges dataCreate a new convert to subtask for a task. Required: parent task id. API summary: Convert task to subtask.
create_task_documentChanges dataCreate a new document for a task. Search documents first to avoid duplicates. API summary: Create an attachment.
create_task_followChanges dataCreate a new follow for a task. API summary: Add followers to a task.
create_task_homeChanges dataCreate a new home for a task. Search homes first to avoid duplicates. API summary: Add a task to the home screen.
create_task_unfollowChanges dataCreate a new unfollow for a task. API summary: Remove followers from a task.
create_unsubscribeChanges dataCreate a new unsubscribe. API summary: Unsubscribe from a specific notifications channel.
create_user_inviteVisible to othersCreate a new invite for a user. Has effects visible outside this system. API summary: Invite an existing user to the Workast team.
create_workflowChanges dataCreate a new workflow. Required: type, trigger or prompt. Search workflows first to avoid duplicates.
delete_a_task_activityDeletesPermanently delete a task by task id 2. Destructive action; may require approval. API summary: Delete a task activity.
delete_activity_reactionDeletesPermanently delete a reaction by reaction id. Destructive action; may require approval. API summary: Remove a reaction.
delete_fieldDeletesPermanently delete a field by field id. Destructive action; may require approval. API summary: Removes a custom field from the team.
delete_list_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a space attachment.
delete_list_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete a Note.
delete_list_participantsMoves moneyPermanently delete a participant by list id. Financial or irreversible action; may require approval. API summary: Remove participants from space.
delete_list_platformsMoves moneyPermanently delete a platform by list id. Financial or irreversible action; may require approval. API summary: Delete a space platform details.
delete_list_taskDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Delete a space activity.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete a Note.
delete_milestoneDeletesPermanently delete a milestone by milestone id. Destructive action; may require approval. API summary: Delete milestone.
delete_milestone_listDeletesPermanently delete a list by list id. Destructive action; may require approval. API summary: Remove list from milestone.
delete_searchDeletesPermanently delete a search by search id. Destructive action; may require approval.
delete_search_homesMoves moneyPermanently delete a home by search id. Financial or irreversible action; may require approval. API summary: Remove search from the home screen.
delete_search_remindersMoves moneyPermanently delete a reminder by search id. Financial or irreversible action; may require approval. API summary: Deletes a reminder from a search.
delete_search_reminders_delete_user_search_reminderMoves moneyPermanently delete a reminder by search id. Financial or irreversible action; may require approval. API summary: Deletes a reminder from a user search.
delete_search_usersMoves moneyPermanently delete a user by search id. Financial or irreversible action; may require approval. API summary: Remove Search from users.
delete_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval.
delete_taskDeletesDelete a task by `task_id`.
delete_task_dependencyDeletesPermanently delete a dependency by dependency id. Destructive action; may require approval. API summary: Remove a dependency.
delete_task_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a task attachment.
delete_task_homesMoves moneyPermanently delete a home by task id. Financial or irreversible action; may require approval. API summary: Remove a task from the home screen.
delete_task_tagsMoves moneyPermanently delete a tag by task id. Financial or irreversible action; may require approval. API summary: Delete a tag from a task.
delete_workflowDeletesPermanently delete a workflow by workflow id. Destructive action; may require approval.
detach_assigned_to_taskMoves moneyDetach a assigned (task id). Financial or irreversible action; may require approval. API summary: Unassign task.
export_usersChanges dataExport users. API summary: Export all the user data to a JSON file and send it by email.
get_a_note_detailsGet one message by message id. API summary: Get a Note details.
get_calendar_integration_settingsList settings. API summary: Get calendar integration settings.
get_current_userGet the Workast user the API token belongs to.
get_list_messageGet one message for a list by message id. API summary: Get a Note details.
get_meetingGet one meeting by meeting id. API summary: Get meeting details.
get_messageGet one message by email. API summary: Get user by email.
get_milestoneGet one milestone by `milestone_id`.
get_searchGet one search by search id. API summary: Get a Search details.
get_slack_channelGet one slack channel by channel id. API summary: Get Space details by Slack channel ID.
get_slugGet one slug by slug slug. API summary: Get space details by slug.
get_spaceGet one space by `list_id`.
get_taskGet one task by `task_id`, with assignees, due date and subtasks.
get_task_2Get one task by user id. API summary: Count user tasks.
get_task_by_short_idGet a task by its short ID (`short_id`) as shown in Workast.
get_the_token_detailsList mes. API summary: Get the token details.
get_userGet one user by user id. API summary: Get user details.
get_usernameGet one username by user name. API summary: Get user by username.
get_workflowGet one workflow by workflow id. Results are paginated. API summary: Get a specific workflow.
list_appsList apps. Optional filters: sort or list id. Results are paginated. API summary: List available apps in Workast.
list_attachment_documentsList documents for a attachment. Optional filters: download. API summary: Get a signed URL to download an attachment file.
list_eventsList events. Optional filters: from, to or tzid. API summary: List user calendar events.
list_fieldsList fields. Optional filters: list id. API summary: List the custom fields available in the team.
list_homesList homes. API summary: Get the user's home tasks.
list_list_participantsList participants for a list. API summary: List space participants.
list_meetingsList meetings. Optional filters: time min, time max or attendees. Results are paginated.
list_messagesList messages. Optional filters: show deleted, lists, title, owners or sort. Results are paginated. API summary: List notes.
list_milestonesList milestones, optionally by `list` (space) or `status`.
list_personalsList personals. API summary: Get the personal space.
list_productsList products. Optional filters: sort. Results are paginated. API summary: Get available products.
list_settingsList settings. API summary: Get the user notification settings.
list_space_notesList the notes in a space by `list_id`.
list_space_tasksList tasks in a space by `list_id`, optionally by `status_is`, with paging.
list_spacesList spaces (task lists), filtered by `name`, `type`, `status_is` or participants, with paging.
list_sublistsList sublists. Optional filters: only user lists or type. API summary: Get all space lists.
list_tagsList the tags in your workspace.
list_user_tasksList tasks for a user by `user_id`, filtered by `assigned_to`, `status_is`, `due_on` or `created_by`.
list_usersList users in your team, filtered by `name`, `email` or `status`.
reopen_taskChanges dataMark a done task as not done by `task_id`.
restore_listChanges dataUnarchive a list (list id). API summary: Unarchive a space.
restore_milestoneChanges dataRestore a milestone (milestone id). API summary: Restore milestone.
restore_taskChanges dataRestore a task (task id).
search_homesSearch homes. Use this to find existing homes before creating a new home. Results are paginated. API summary: Find suggested searches for the user to add to the home screen.
search_list_documentsSearch documents for a list by types or name. Use this to find existing documents before creating a new document. Results are paginated. API summary: List space attachments.
search_list_tasksSearch tasks for a list by type, actor types or sort. Use this to find existing tasks before creating a new task. Results are paginated. API summary: Search space activities.
search_metadataSearch metadata by query. Use this to find existing metadata before creating a new metadata. Results are paginated. API summary: Get app metadata.
search_notificationsSearch notifications by read or sort. Use this to find existing notifications before creating a new notification. Results are paginated. API summary: Search user notifications.
search_searchesSearch searches by sort or home. Use this to find existing searches before creating a new search. Results are paginated. API summary: Find all Searches associated to the logged in user.
search_task_activitiesSearch tasks for a task by type, actor types or sort. Use this to find existing tasks before creating a new task. Results are paginated. API summary: Search task activities.
search_tasksSearch tasks by text `q`, `assigned_to`, `status_is`, `due_on`, `in_list` and more, with paging.
search_tasks_searchChanges dataSearch tasks. Use this to find existing tasks before creating a new task.
search_workflowsSearch workflows. Use this to find existing workflows before creating a new workflow. Results are paginated. API summary: Find workflows.
submit_taskVisible to othersClone a task (task id). Has effects visible outside this system.
submit_userVisible to othersActivate a user (user id). Has effects visible outside this system. API summary: Activate user.
submit_workflowVisible to othersActivate a workflow (workflow id). Has effects visible outside this system.
update_a_task_activityChanges dataUpdate an existing task identified by task id 2. Only the fields you pass are changed. API summary: Update a task activity.
update_fieldChanges dataUpdate an existing field identified by field id. API summary: Update a custom field.
update_list_documentChanges dataUpdate an existing document identified by document id. Only the fields you pass are changed. API summary: Update a space attachment.
update_list_messageChanges dataUpdate an existing message identified by message id. Only the fields you pass are changed. API summary: Update a Note.
update_list_taskChanges dataUpdate an existing task identified by task id. Only the fields you pass are changed. API summary: Update a space activity.
update_messageChanges dataUpdate an existing message identified by message id. Only the fields you pass are changed. API summary: Update a Note.
update_milestoneChanges dataUpdate a milestone by `milestone_id`: name, start or end date.
update_milestone_listChanges dataUpdate an existing list identified by list id. API summary: Add list to milestone.
update_searchChanges dataUpdate an existing search identified by search id. Only the fields you pass are changed. API summary: Update a Search.
update_search_remindersVisible to othersUpdate an existing reminder identified by search id. Has effects visible outside this system. API summary: Sets a reminder for the search.
update_settingsVisible to othersUpdate an existing setting. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update user notification settings.
update_spaceChanges dataUpdate a space by `list_id`: name, description or columns.
update_tagChanges dataUpdate an existing tag identified by tag id. Only the fields you pass are changed. API summary: Update a tag.
update_taskChanges dataUpdate a task by `task_id`: text, description, due date, start date or repeat. Only the fields you pass change.
update_task_dependencyChanges dataUpdate an existing dependency identified by dependency id. API summary: Add a dependency.
update_task_documentChanges dataUpdate an existing document identified by document id. Only the fields you pass are changed. API summary: Update a task attachment.
update_tasksVisible to othersUpdate an existing task. Has effects visible outside this system. API summary: Update many tasks.
update_team_avatarsVisible to othersUpdate an existing avatar identified by team id. Has effects visible outside this system. API summary: Update a team avatar.
update_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed. API summary: Update the user settings of the logged in user.
update_user_avatarsVisible to othersUpdate an existing avatar identified by user id. Has effects visible outside this system. API summary: Update the user avatar.
update_user_rolesMoves moneyUpdate an existing role identified by user id. Only the fields you pass are changed. Financial or irreversible action; may require approval. API summary: Update the user role.
update_workflowChanges dataUpdate an existing workflow identified by workflow id. Only the fields you pass are changed. API summary: Update a workflow.
upload_importChanges dataUpload a import (template id). API summary: Import template.
upload_libraryChanges dataUpload a library (library template id). API summary: Import template from library.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Workast from the app list.
2
Paste your key
Paste a Workast API token. You need a paid or trial Workast account. In the Workast web app click your name in the top right > Preferences > API and generate a new API token. Generating a new token replaces any previous one.
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 Workast?

The AI can read spaces, space notes, tasks, milestones, tags and users, and search tasks by text, assignee, status and due date. It can create and update tasks, spaces and milestones, add subtasks, assign users, add tags and comments, complete and reopen tasks, complete milestones and delete tasks.

Does the AI see my Workast credentials?

No. Your Workast API token is encrypted at rest and never shown to the AI. After you save them, they are 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 read-only. Deleting a task removes it, so that tool can require your approval before it runs, and you can leave it switched off. 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 with no credit card required. Paid plans bill per completed task. You also need your own Workast account.

Will a new Workast token break other integrations?

Generating a new API token in Workast replaces any previous one. If another integration uses the old token, it stops working. If you already use a token elsewhere, update that integration with the new token too.