Matrix Connector for AI agents.

19 live capabilities

Manage decentralized rooms and secure messages from your AI client.

Live agent request Matrix / Connector

Waiting for input…

AI Agent

Why people use Matrix

Matrix/Element for Automating Decentralized Room Management

This Connector changes that by letting your AI agent do the work. You can just tell your agent to create a room or update the state. It handles the protocol details for you, so you can stay in your flow and let the agent manage the logistics.

What Vinkius changes

You get a direct line for your AI to act on your behalf within the Matrix ecosystem.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 6,100+ Connectors

Real-world use case 01

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.
Real-world use case 02

Community Growth

A manager searches for a new user and sends a welcome message to a specific room using search_user_directory.
Real-world use case 03

Secure Archiving

A privacy advocate syncs their client to pull the latest encrypted messages into a summary using sync_client.

Complete set · 19capabilities

The complete Matrix capability set.

These are the exact actions your AI can choose when you ask it to work with Matrix.

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 19 available through Matrix.

01 Capability
Change password
Update your account password. Use this for routine security maintenance.
02 Capability
Claim keys
Take ownership of E2EE keys from the homeserver. This is vital for accessing old messages.
03 Capability
Sync client
Refresh your client's state with the homeserver. This ensures your agent sees the latest updates.
04 Capability
Create room
Build a new room on the Matrix network. Use this to start a new conversation thread.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 19 available through Matrix.

05 Capability
Deactivate account
Shut down your Matrix account. Use this for permanent account removal.
06 Capability
Download media
Pull media files from the homeserver. This lets your agent grab files for you.
07 Capability
Get room state
Fetch the current state events for a specific room. This helps your agent understand the room's configuration.
08 Capability
Join room
Join a Matrix room using either its ID or alias. Use this to get your agent into the conversation.

Capability set03 / 05

09—12

4 capabilities in this set.

Part of 19 available through Matrix.

09 Capability
Knock room
Request access to a room by knocking on it. This is the first step for joining private spaces.
10 Capability
Leave room
Exit a Matrix room immediately. Use this to clean up your agent's presence.
11 Capability
Login account
Log into your Matrix account. This establishes the initial connection for your session.
12 Capability
Logout account
Sign out of your current session. Use this to end your agent's access.

Capability set04 / 05

13—16

4 capabilities in this set.

Part of 19 available through Matrix.

13 Capability
Query keys
Ask the homeserver for existing E2EE keys. It's necessary for maintaining secure chat history.
14 Capability
Register account
Create a new Matrix account from scratch. Use this to set up a new identity.
15 Capability
Search user directory
Look for specific users in the global directory. This helps find people to message.
16 Capability
Send message
Send a text message or custom event to a room. This is the primary way to communicate.

Capability set05 / 05

17—19

3 capabilities in this set.

Part of 19 available through Matrix.

17 Capability
Set room state
Update the state events for a room. Use this to change room settings or metadata.
18 Capability
Upload media
Send images or files to the homeserver. This lets your agent share more than just text.
19 Capability
Upload keys
Send your E2EE keys to the homeserver. This allows others to send you encrypted messages.

Set up in minutes

One URL. Then ask Matrix to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Matrix from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Matrix, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Matrix for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Matrix URL.
Step 03

Save and start

Save the connection and enable Matrix in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "matrixelement": {
      "url": "https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Matrix

Open Agent mode in chat and ask: "Using Matrix, help me...". 19 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "matrixelement": {
      "url": "https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Matrix

Ask Copilot: "Using Matrix, help me...". 19 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "matrixelement": {
      "url": "https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Matrix

Open Cascade and ask: "Using Matrix, help me...". 19 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "matrixelement": {
      "url": "https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Matrix

Ask Cline: "Using Matrix, help me...". 19 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add matrixelement --transport http "https://edge.vinkius.com/vk_preview_7FEeYnVTUWoeZZWgbVgwWO7Bd4xLwgOKwHc6oxrN/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Matrix

Ask Claude: "Using Matrix, show me...". 19 tools are ready

Where the request belongs

Work Matrix can move forward.

Built around the request

This is for the privacy-conscious engineer or community lead who manages dozens of rooms but hates the friction of manual switching.

01

DevOps Engineer

Automates alert room creation and incident responses without leaving the terminal.

02

Community Manager

Handles user invitations and room state changes across large decentralized networks.

03

Privacy Advocate

Keeps sensitive communications secure and automated within a decentralized framework.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Flock

Manage team collaboration via Flock. send rich messages with FlockML, handle public channels and private groups, and search rosters directly from any AI agent.

02 18 capabilities

Sendbird

Manage Sendbird chat infrastructure. orchestrate users, channels, and moderation directly from your AI agent.

03 11 capabilities

Netease Yunxin IM

Equip your AI Agent with Netease Yunxin to massively manage Live Chat Rooms, moderate IM participants, and broadcast messages.

04 19 capabilities

Liveblocks (Collaborative)

Manage real-time collaborative rooms, user presence, and shared storage via Liveblocks. list rooms, track active users, and handle threads directly from your AI agent.

05 18 capabilities

Liveblocks

Manage real-time collaboration infrastructure—create rooms, authorize users, and inspect collaborative storage or threads directly from your AI agent.

06 31 capabilities

PubNub (Real-time Messaging)

Enable real-time messaging, presence tracking, and message history for your AI agent using PubNub's global data stream network.

Bring your own AI

Change the model, client or framework. Keep Matrix connected.

Before you connect

Questions about Matrix.

The practical details behind the request, access and result.

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 capability. 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 capability 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.

One connection away

Give your agent a direct line to Matrix.

Connect Matrix once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available