How to Use the Matrix/Element MCP in Claude Code

Q: How do I register the Matrix/Element MCP Server in Claude Code?

Run claude mcp add --transport http matrixelement in your terminal. This command registers the 19 tools inside your global CLI configuration file.

Q: Does Claude Code support Matrix/Element user directory queries?

Yes. Claude Code runs searchuserdirectory to find users matching your search strings. It outputs the results directly to your stdout for easy piping.

Q: Can I manage Matrix/Element room memberships using Claude Code?

Yes. Claude Code uses joinroom and leaveroom to manage which spaces your CLI agent occupies. It lets you automate room cleanup scripts directly from the command line.

Q: How does Claude Code authenticate with Matrix/Element homeservers?

The agent uses loginaccount to establish a session token and logoutaccount to terminate it. Vinkius handles the underlying token exchange over MCP securely so you don't expose raw passwords.

Automate Matrix/Element notifications and E2EE key management from your terminal with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Matrix/Element MCP to Claude Code

Create your Vinkius account to connect Matrix/Element to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Matrix/Element with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Headless Terminal Alerts with Claude Code

The `send_message` tool posts raw JSON payloads or text messages directly to any room ID. Claude Code executes this tool via the MCP Server inside your terminal sessions to alert your team of deployment statuses. You can pipe terminal outputs directly into the agent. It parses the errors, formats the text, and sends the alert to your incident response room without opening a browser.

Programmatic Room State Management

The `set_room_state` tool modifies room configurations, aliases, and permissions via the command line. Claude Code uses this MCP capability to update these settings instantly during system migrations or access updates. If you need to audit current configurations, the agent uses `get_room_state` to dump the raw JSON. It checks permissions and flags security anomalies directly in your terminal.

Command-Line Key and Session Sync

The `sync_client` tool pulls the latest updates from your homeserver directly to your terminal. Claude Code uses this MCP tool to keep your local session state synchronized during long-running shell scripts. For secure setups, the agent calls `upload_keys` to register your cryptographic identity. This lets you run headless, secure automation without breaking end-to-end encryption.

Setup guide

Set up Matrix/Element MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see matrixelement-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Matrix/Element transactions." It will automatically discover and invoke the available Matrix/Element tools.

Terminal

claude mcp add --transport http matrixelement-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Matrix/Element MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "matrixelement-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Matrix. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Matrix/Element now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Matrix/Element MCP in Claude Code

Run `claude mcp add --transport http matrixelement ` in your terminal. This command registers the 19 tools inside your global CLI configuration file.

Yes. Claude Code runs `search_user_directory` to find users matching your search strings. It outputs the results directly to your stdout for easy piping.

Yes. Claude Code uses `join_room` and `leave_room` to manage which spaces your CLI agent occupies. It lets you automate room cleanup scripts directly from the command line.

The agent uses `login_account` to establish a session token and `logout_account` to terminate it. Vinkius handles the underlying token exchange over MCP securely so you don't expose raw passwords.

Vinkius routes all media files and message payloads through ephemeral V8 Isolate Sandboxes. Your data is processed in-memory and destroyed immediately after the CLI command finishes executing.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript