Integration · Communication

Connect Claude & ChatGPT to Alterdesk

Ask your AI what you missed in a group chat, how many unread messages you have or who is in a project chat, and it reads the answer from Alterdesk. It can post in group chats and one-to-one chats, start new group chats, add members, invite external contacts and flag or bookmark chats. Messages that others see right away can require your approval first.

Connect Alterdesk free

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

Try asking

“How many unread chats and messages do I have?”
The AI gets your unread counts for chats and messages.
“Summarize the latest messages in the Project Nord group chat.”
It finds the group chat in your list and reads its recent messages, page by page.
“Post in Project Nord that the meeting moves to 14:00.”
It posts the message in the group chat. All members see it right away.

What your AI can do

Chats and messages

List your group chats and one-to-one chats with coworkers and contacts, read messages and attachments, and see unread counts.

Post and organize

Send messages in group chats and one-to-one chats, rename group chats, and set flags, bookmarks and important markers.

People and members

Search coworkers and contacts, read user profiles, create group chats, add members and invite external contacts by email.

“Start a group chat called Launch with Lars and Mette.”
It searches your coworkers to find their user IDs and creates the group chat with them as members.
“Invite [email protected] as an external contact.”
It invites the contact by email. Alterdesk sends her an invitation email.
“Which files have been shared in the Launch chat?”
It lists the attachments shared in that group chat.

77 tools for Alterdesk

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

add_group_chat_membersDeletesAdd members to a group chat by `groupchat_id`, with user IDs in `members` or people to invite in `invite_members`.
attach_groupchatChanges dataLink a groupchat (groupchat id). API summary: Retrieve a link to the Groupchat.
cancel_inviteDeletesCancel a invite (user id). Destructive action; may require approval. API summary: Cancel an invitation.
create_companyChanges dataCreate a new company. Required: event name, method or url. API summary: Add a Webhook event to your Company.
create_group_chatChanges dataCreate a group chat with a `subject` and `members` (user IDs); optional settings and `invite_users` to invite people by email.
create_groupchat_hookChanges dataCreate a new hook for a groupchat. Required: event name, method or url. API summary: Add a Webhook event to the GroupChat.
create_idChanges dataCreate a new id. Required: items. API summary: Retrieve a list of Groupchats by IDs.
create_userVisible to othersCreate a new user. Required: email. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Invite a coworker.
create_user_invite_private_using_postVisible to othersCreate a new user. Required: email. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Invite a private user.
create_user_provision_api_user_using_postChanges dataCreate a new user. Search users first to avoid duplicates. API summary: Provision a Private API User.
delete_chat_messageDeletesDelete one message from a one-to-one chat by `conversation_id` and `message_id`. This cannot be undone.
delete_companiesMoves moneyPermanently delete a company. Financial or irreversible action; may require approval. API summary: Remove a Webhook event from your Company.
delete_group_chat_messageDeletesDelete one message from a group chat by `groupchat_id` and `message_id`. This cannot be undone.
delete_groupchatDeletesPermanently delete a groupchat by groupchat id. Destructive action; may require approval. API summary: Close Groupchat.
delete_groupchat_adminsMoves moneyPermanently delete a admin by groupchat id. Financial or irreversible action; may require approval. API summary: Remove Groupchat admins.
delete_groupchat_hooksMoves moneyPermanently delete a hook by groupchat id. Financial or irreversible action; may require approval. API summary: Remove a Webhook event to the GroupChat.
delete_groupchat_usersMoves moneyPermanently delete a user by groupchat id. Financial or irreversible action; may require approval. API summary: Remove members from the Groupchat.
delete_mesMoves moneyPermanently delete a me. Financial or irreversible action; may require approval. API summary: Delete User.
download_groupchat_pdfDownload the pdf document for a groupchat. API summary: Retrieve the messages as PDF from the Groupchat.
download_message_pdfDownload the pdf document for a message. API summary: Retrieve the messages as PDF from the Conversation.
get_a_link_to_the_verificationList verifications for a message. Optional filters: headers. API summary: Get a link to the Verification.
get_chatGet one one-to-one chat; pass the chat's ID (conversation ID) as `message_id`.
get_chat_messageGet one message in a one-to-one chat by `conversation_id` and `message_id`.
get_group_chatGet one group chat by `groupchat_id`.
get_group_chat_messageGet one message in a group chat by `groupchat_id` and `message_id`.
get_groupchat_documentGet one document for a groupchat by document id. API summary: Retrieve an Attachment from the Groupchat.
get_meGet your own Alterdesk profile. Use to confirm which account you are signed in as.
get_message_documentGet one document for a message by document id. API summary: Retrieve an Attachment from the Conversation.
get_the_webhook_events_of_your_companyList companies. API summary: Get the Webhook Events of your Company.
get_unread_countsGet how many unread chats and messages you have.
get_userGet a user's profile by `user_id`.
get_user_2Get one user by user id. API summary: Retrieve a user of the company.
invite_contactVisible to othersInvite an external contact by `email`, with optional first name, last name and language. Alterdesk sends them an invitation email.
list_chat_attachmentsList the files shared in a one-to-one chat by `conversation_id`.
list_chat_messagesList the messages in a one-to-one chat by `conversation_id`, with `page` and `amount` paging.
list_companiesList companies. API summary: Retrieve the information of the company.
list_contact_chatsList your one-to-one chats with external contacts, with `page` and `amount` paging.
list_coworker_chatsList your one-to-one chats with coworkers, with `page` and `amount` paging.
list_group_chat_attachmentsList the files shared in a group chat by `groupchat_id`.
list_group_chat_membersList the members of a group chat by `groupchat_id`.
list_group_chat_messagesList the messages in a group chat by `groupchat_id`, with `page` and `amount` paging.
list_group_chatsList your group chats, with `page` and `amount` paging; set `members` to include members.
list_groupchat_chatsList chats for a groupchat. Optional filters: headers. API summary: Get a link to the Chat Embed.
list_groupchat_framesList frames for a groupchat. Optional filters: language, background color, button color, button hover color, members button or headers. API summary: Retrieve a link to the Groupchat Frame.
list_groupchat_hooksList hooks for a groupchat. API summary: Get the Webhook Events from the GroupChat.
list_groupchat_videosList videos for a groupchat. Optional filters: headers, auto start or controls show. API summary: Get a link to the Video Embed.
list_groupchat_zipsList zips for a groupchat. Optional filters: start date, end date, headers or include transcript. API summary: Retrieve the messages and attachments as ZIP from the Groupchat.
list_message_likesList likes for a message. API summary: Get a list of Users who liked the Message.
list_message_likes_get_likes_using_get_3List likes for a message. API summary: Get a list of Users who liked the Message.
list_message_seensList seens for a message. API summary: Get a list of Users who have seen the Message.
list_message_seens_get_seen_by_using_get_3List seens for a message. API summary: Get a list of Users who have seen the Message.
list_message_verificationsList verifications for a message. Optional filters: headers. API summary: Get a link to the Verification.
list_sharedsList shareds. API summary: Retrieve a list of Shared users.
list_themesList themes. Optional filters: type. API summary: Retrieve theme.
list_user_activationsList activations for a user. API summary: Resend the activation mail of a user of the company.
list_user_providersList providers for a user. API summary: Retrieve providers available for User.
list_user_verificationsList verifications for a user. API summary: Retrieve verifications of User.
list_verificationsList verifications. API summary: Retrieve verifications.
retrieve_a_list_of_usersList users. Optional filters: amount. Results are paginated. API summary: Retrieve a list of Users.
search_contactsSearch your contacts by name or email with `query`. Use to find a contact's user ID.
search_coworkersSearch your coworkers by name or email with `query`. Use to find a coworker's user ID.
search_usersSearch users by query, amount or mode. Use this to find existing users before creating a new user. Results are paginated. API summary: Retrieve a list of users of the company.
send_chat_messageVisible to othersSend a message with text `body` in a one-to-one chat by `conversation_id`. The other person sees it right away.
send_group_chat_messageVisible to othersPost a message with text `body` in a group chat by `groupchat_id`. All members see it right away.
send_me_eventsVisible to othersEmail a me. Has effects visible outside this system. API summary: Retrieve a list of Email Events.
send_verificationVisible to othersSend a verification (conversation id). Has effects visible outside this system. API summary: Post a new Verification Request in the Conversation.
send_verification_send_verification_request_using_post_3Visible to othersSend a verification (groupchat id). Has effects visible outside this system. API summary: Post a new Verification Request in the Groupchat.
update_chatChanges dataSet a one-to-one chat's flag (flagged, done, none), bookmark or important marker; pass the chat's ID as `message_id`.
update_email_eventDeletesEmail a me. Destructive action; may require approval. API summary: Update Email Event.
update_group_chatChanges dataRename a group chat (`subject`) or set its flag (flagged, done, none), bookmark or important marker by `groupchat_id`.
update_groupchat_adminsVisible to othersUpdate an existing admin identified by groupchat id. Has effects visible outside this system. API summary: Add Groupchat admins.
update_groupchat_ownersVisible to othersUpdate an existing owner identified by groupchat id. Has effects visible outside this system. API summary: Update Groupchat owner.
update_groupchat_settingsVisible to othersUpdate an existing setting identified by groupchat id. Has effects visible outside this system. API summary: Update Groupchat Settings.
update_mesVisible to othersUpdate an existing me. Has effects visible outside this system. API summary: Update User Profile.
update_message_likesDeletesUpdate an existing like identified by message id. Destructive action; may require approval. API summary: Like Message.
update_userChanges dataUpdate an existing user identified by user id. API summary: Update a user of the company.
upload_companyChanges dataImport a company. API summary: Import users to the company.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Alterdesk from the app list.
2
Paste your key
Create your own Alterdesk application, paste its Client ID and Client Secret, then sign in with your Alterdesk account once. You must be a Company Admin. In Alterdesk open Company Settings, go to the Advanced tab, register a new application and enter the redirect URI https://heymyapps.com/oauth/callback.
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 Alterdesk?

It can list and read your group chats and one-to-one chats, their messages, members and attachments, your unread counts, your profile and other users' profiles, and search coworkers and contacts. It can send and delete messages, create and rename group chats, add members, invite external contacts and set flags, bookmarks and important markers on chats.

Does the AI see my Alterdesk credentials?

No. Your Alterdesk Client ID and Client Secret are 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 with reading chats only. Sending messages and inviting contacts reach other people right away, adding members gives them access to a chat, and deleting a message cannot be undone, so these can require your approval before they run. 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?

Alterdesk connects with OAuth, and OAuth connections need the HeyMyApps Pro plan or above. HeyMyApps also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Alterdesk account.

Whose account does the AI act as?

The AI works as the Alterdesk user who signed in when you connected. It sees the chats that user is in, and messages it sends appear under that user's name. The get_me tool shows which account is signed in.