Comms MCP Server: Setup for Claude, Cursor and Other Apps

• Shows who you are signed in as

  Returns your Comms user ID, name, email, timezone and language.

  Try: “Which Comms account am I using?”

  Network · user-info

• Lists your workspaces

  Returns every workspace you belong to, with IDs, names, creators and plan details.

  Try: “List my Comms workspaces.”

  Network · get-workspaces

• Shows your inbox with unread counts

  Loads inbox threads and conversations for a workspace, with unread counts. You can include threads already marked done.

  Try: “What is unread in my Comms inbox?”

  Network · fetch-inbox

• Opens a thread with its comments

  Loads one thread and its comments. You can filter by time and page through long threads.

  Try: “Open the thread about the Q4 launch and summarize the comments.”

  Network · load-thread

• Opens a direct message with its messages

  Loads one direct or group conversation and its messages, with time filters and paging.

  Try: “Show the last messages in my conversation with Sam.”

  Network · load-conversation

• Lists channels in a workspace

  Lists active channels with names, descriptions, public or private status and links. Archived channels are optional.

  Try: “Which channels exist in the Design workspace?”

  Network · list-channels

• Lists your direct messages

  Lists direct and group conversations with participants, last activity and a snippet. Archived ones are optional.

  Try: “List my recent direct conversations.”

  Network · list-conversations

• Searches threads, comments and messages

  Searches a workspace by keyword. You can narrow by channel, author, date or mentions.

  Try: “Search Comms for threads that mention the pricing change.”

  Network · search-content

• Finds where you were mentioned

  Returns threads, comments and messages that mention you, with channel, author and date filters. Needs no keyword.

  Try: “What did people mention me in this week?”

  Network · get-mentions

• Looks up people in a workspace

  Lists workspace members, or finds specific people by name or email.

  Try: “Find Priya's user ID in the Design workspace.”

  Network · get-users

• Looks up user groups

  Lists groups in a workspace with member counts. It can also list each member.

  Try: “Who is in the Design group?”

  Network · get-groups

• Builds links to Comms items

  Builds a valid link to a thread, comment, conversation or message from its IDs.

  Try: “Give me a link to that thread.”

  Read · build-link

• Creates a channel

  Creates a channel in a workspace with an optional description, visibility and starting members. It is private unless you say public.

  Try: “Create a private channel called launch-planning.”

  Write · create-channel

• Renames or edits a channel

  Changes a channel's name, description or visibility. It can also clear the description.

  Try: “Rename the channel launch-planning to launch-2027.”

  Write · update-channel

• Starts a new thread in a channel

  Posts a new thread with a title and body. You can notify chosen people, groups or the whole channel.

  Try: “Start a thread in #design titled Weekly review and tag the Design group.”

  Write · create-thread

• Starts a direct or group message

  Opens a conversation with one or more people and posts the first message. It reuses an existing conversation with the same people.

  Try: “Message Sam and Priya: standup moved to 10am.”

  Write · create-conversation

• Replies to a thread or conversation

  Posts a comment on a thread or a message in a conversation. Thread replies notify everyone who took part unless you choose recipients.

  Try: “Reply to the launch thread: approved, ship it.”

  Write · reply

• Adds or removes an emoji reaction

  Reacts to a thread, comment or message with an emoji, or removes the reaction.

  Try: “Add a thumbs up to Sam's last message.”

  Write · react

• Edits a thread, comment or message

  Changes the text of a thread, comment or message. A thread can also be renamed.

  Try: “Fix the typo in my last comment on the launch thread.”

  Write · update-object

• Permanently deletes a thread, comment or message

  Deletes a thread with all its comments, or one comment or message. It cannot be undone, and only the author or a workspace admin can do it.

  Try: “Delete my comment on the roadmap thread.”

  Delete · delete-object

• Marks threads or conversations done

  Marks items as read and archives them. It works on single IDs or in bulk for a whole workspace or channel.

  Try: “Mark everything in #announcements as done.”

  Write · mark-done

• Marks items read without archiving

  Clears the unread marker but leaves items in the inbox. It can do one item or everything unread in a workspace.

  Try: “Mark all my unread threads as read.”

  Write · mark-read

Watch out for

• It can permanently delete threads and messages

  The delete tool is marked destructive and cannot be undone. Only the author or a workspace admin can delete, but ask the assistant to confirm each one. github.com

• Posts and replies notify real people

  Replying to a thread notifies everyone who took part by default. Read a draft before you let the assistant send it. raw.githubusercontent.com

• The key acts as your whole Comms account

  The README gives no narrower scope for the personal token, so it can reach whatever you can reach. raw.githubusercontent.com

Security advisories