# Matrix/Element MCP for AI Agents AI Agent Connect > Matrix/Element MCP lets your AI agent handle your decentralized communications. You can create rooms, send messages, and manage your account state without leaving your current workspace. It connects your Matrix identity to your AI client so you can automate secure messaging and room management through natural conversation. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/ai-agent-connect - **Tags:** matrix, element, chat, decentralized, e2ee ## Description This Connector lets you put your Matrix account on autopilot. Instead of jumping between tabs to manage decentralized rooms or send secure messages, you can just tell your AI agent what to do. It handles the heavy lifting of interacting with the Matrix protocol, from creating new rooms and joining existing ones to searching for users across the network. If you need to keep your communications encrypted, it manages your keys and state synchronization behind the scenes. It's built for people who need to stay connected on Matrix but want to move faster. By adding this to your setup on the Vinkius Marketplace, you bridge the gap between your private messages and your AI-driven workflow. You don't have to worry about the underlying protocol; just tell your agent to send a message or join a room, and it happens. It's about making your decentralized identity work for you, not the other way around. ## Tools ### change_password Update your account password. Use this for routine security maintenance. ### claim_keys Take ownership of E2EE keys from the homeserver. This is vital for accessing old messages. ### sync_client Refresh your client's state with the homeserver. This ensures your agent sees the latest updates. ### create_room Build a new room on the Matrix network. Use this to start a new conversation thread. ### deactivate_account Shut down your Matrix account. Use this for permanent account removal. ### download_media Pull media files from the homeserver. This lets your agent grab files for you. ### get_room_state Fetch the current state events for a specific room. This helps your agent understand the room's configuration. ### join_room Join a Matrix room using either its ID or alias. Use this to get your agent into the conversation. ### knock_room Request access to a room by knocking on it. This is the first step for joining private spaces. ### leave_room Exit a Matrix room immediately. Use this to clean up your agent's presence. ### login_account Log into your Matrix account. This establishes the initial connection for your session. ### logout_account Sign out of your current session. Use this to end your agent's access. ### query_keys Ask the homeserver for existing E2EE keys. It's necessary for maintaining secure chat history. ### register_account Create a new Matrix account from scratch. Use this to set up a new identity. ### search_user_directory Look for specific users in the global directory. This helps find people to message. ### send_message Send a text message or custom event to a room. This is the primary way to communicate. ### set_room_state Update the state events for a room. Use this to change room settings or metadata. ### upload_media Send images or files to the homeserver. This lets your agent share more than just text. ### upload_keys Send your E2EE keys to the homeserver. This allows others to send you encrypted messages. ## Prompt Examples **Prompt:** ``` Join the room !dev:matrix.org and tell everyone the site is live. ``` **Response:** ``` I've joined the room and sent the message. **Room Status:** - **Room:** `!dev:matrix.org` - **Action:** Joined successfully - **Message:** "The site is live." - **Status:** Delivered ``` **Prompt:** ``` Search for a user named 'admin' and send them a message. ``` **Response:** ``` I found a matching user: **admin_user (@admin:matrix.org)**. I've sent them a message. **Details:** - **Recipient:** @admin:matrix.org - **Status:** Sent - **Transaction ID:** `txn_987654321` ``` **Prompt:** ``` Sync my messages and tell me what I missed. ``` **Response:** ``` I've synchronized your client with the homeserver. **New Activity:** - 3 new messages in `!engineering:matrix.org` - 1 new invitation to `Project X` - 2 new events in `!general:matrix.org` ``` ## Capabilities ### Create and join rooms Your agent can automatically build new rooms or enter existing ones using IDs or aliases. ### Send messages and events Send text messages or custom events to any room while the agent tracks the transaction. ### Sync client state Keep your agent updated on the latest conversations by fetching the current state from the homeserver. ### Search user directory Find specific users across the global directory to initiate new connections. ### Manage account profile Handle account registration, password changes, and deactivation through your AI client. ### Handle encryption keys Manage E2EE keys to ensure your agent can communicate securely with others. ### Upload and download media Move images and files between the homeserver and your agent for easier sharing. ## Use Cases ### Incident Response A DevOps engineer asks their agent to create an alert room and send a notification to the team using create_room and send_message. ### Community Growth A manager searches for a new user and sends a welcome message to a specific room using search_user_directory. ### Secure Archiving A privacy advocate syncs their client to pull the latest encrypted messages into a summary using sync_client. ### Media Sharing A user asks the agent to download a file from a room and summarize its contents using download_media. ## Benefits - Automate room management by using create_room and join_room to set up spaces without manual clicks. - Keep your agent updated on all conversations by running sync_client to fetch the latest messages. - Maintain high security standards by using upload_keys and claim_keys for end-to-end encryption. - Handle large-scale community interactions by using search_user_directory to find and message new members. - Manage your account lifecycle including register_account and change_password for better security. - Share rich content like images and files using upload_media and download_media directly through your agent. ## How It Works The bottom line is you get a direct line for your AI to act on your behalf within the Matrix ecosystem. 1. Subscribe to this Connector on Vinkius and grab your credentials. 2. Input your Matrix Homeserver URL and Access Token into your AI client. 3. Start asking your agent to send messages or manage rooms. ## Frequently Asked Questions **Can I use the Matrix/Element MCP with Claude?** Yes, you can use this Connector with Claude or any other MCP-compatible client like Cursor or Windsurf. **Does the Matrix/Element MCP support encrypted messages?** Yes, it handles the cryptographic keys required for end-to-end encryption, ensuring your private chats remain secure. **How do I connect my account to the Connector?** You just need to provide your Matrix Homeserver URL and your Access Token in your AI client settings. **Can my agent create rooms for me?** Yes, your agent can create new rooms, join existing ones, and even knock on private rooms to request access. **Is this for private servers?** Yes, this works with any Matrix homeserver, whether it is a public one like matrix.org or a private instance. **Can I send images with this?** Yes, the Connector allows your agent to upload and download media files, so you can share more than just text. **How do I see the latest messages in my rooms?** Use the `sync_client` tool. It synchronizes your local state with the homeserver, retrieving all new events, messages, and room state changes since your last sync. **Can I search for people on other Matrix servers?** Yes, the `search_user_directory` tool allows you to search the directory available to your homeserver, helping you find users by their display name or Matrix ID. **Is it possible to manage room settings like the topic or name?** Absolutely. Use `set_room_state` to update room metadata. You can change the room name, topic, or other state events by providing the correct `event_type` and `body`.