Skip to main content
Feedback

Matrix MCP connector

Matrix is an open standard for decentralized, real-time communication that enables secure messaging across federated homeservers. The Matrix MCP connector allows AI agents to send messages to rooms, create and manage rooms, and control user participation through invites, joins, kicks, and bans. It also supports retrieving current user information, fetching joined rooms, and unbanning users to restore access.

Authentication type

  • API Key - Requires a static API key to be configured before the agent can connect to the service.

Uses

Use the Matrix MCP connector to perform the following actions:

  • Broadcast urgent notifications to team channels in real-time
  • Route support requests to dedicated Matrix rooms by category
  • Archive conversations and retrieve historical events for compliance
  • Automate user onboarding by creating rooms and inviting team members
  • Enforce access controls by removing, banning, or kicking users from rooms
  • Integrate chat notifications into business process workflows
  • Share documents and media files through Matrix rooms to distribute content

Example prompts

Use the following example prompts to invoke Matrix MCP connector tools from your AI assistant or Boomi Connect workflow:

  • Create a new Matrix room for our Q4 product launch team.
  • Show me all the Matrix rooms I've joined so far.
  • Send a message to the support-tickets room with today's incident summary.
  • Invite sarah@company.com to the engineering-updates Matrix room.
  • Get the current user information from my Matrix account.
  • Download the contract file that was shared in the contracts-approval room.
  • Leave me out of the old-projects Matrix room.
  • Ban this user from the customer-data room due to access violation.
  • Retrieve the latest room state event from the announcements channel.
  • Kick the inactive intern from all team communication rooms in Matrix.

Matrix MCP connector tools

The Matrix MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.

ToolDescription
getMeRetrieves the profile and account information for the currently authenticated user.
createRoomCreates a new chat room with specified settings and configuration options.
getJoinedRoomsLists all chat rooms that the current user has joined.
inviteUserSends an invitation to a user to join a specific room.
joinRoomAdds the current user to an existing room.
leaveRoomRemoves the current user from a room they have joined.
kickUserRemoves a specified user from a room.
banUserPrevents a specified user from joining or accessing a room.
unbanUserRestores access for a user who was previously banned from a room.
sendMessageSends a text message to a room.
getEventRetrieves the details and content of a specific room event.
getRoomStateRetrieves the current state configuration for a room.
setRoomStateUpdates or sets the state configuration for a room.
downloadMediaRetrieves and downloads media files stored in the chat system.
On this Page