MCP server for Matrix — interact with Matrix homeservers via Model Context Protocol
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-server-matrix","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-server-matrix [](README.ru.md) A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for [Matrix](https://matrix.org) — the open, decentralized communication protocol. Built on [matrix-nio](https://github.com/matrix-nio/matrix-nio), this server lets any MCP-compatible AI assistant (Claude, OpenClaw, etc.) send and read messages, manage rooms, and interact with any Matrix homeserver (Synapse, Dendrite, Conduit). ## Features | Tool | Description | |------|-------------| | `send_message` | Send a message (text, HTML, or Markdown) with optional reply | | `read_messages` | Read recent messages (with pagination) | | `get_messages_by_date` | Get messages filtered by date range | | `list_rooms` | List all joined rooms | | `get_room_info` | Room details — name, topic, members, encryption status | | `get_room_members` | List joined members with display names and avatars | | `get_notification_counts` | Unread and mention counts per room | | `get_direct_messages` | List DM conversations with unread status | | `send_direct_message` | Send a DM (auto-creates room if needed) | | `get_user_profile` | User profile — display name, avatar | | `join_room` | Join a room by ID or alias | | `leave_room` | Leave a room | | `create_room` | Create a new room (with optional invites) | | `invite_user` | Invite a user to a room | | `send_reaction` | React to a message with an emoji | | `resolve_alias` | Resolve `#alias:server` to a room ID | ## Installation ```bash pip install mcp-server-matrix ``` Or with [uv](https://docs.astral.sh/uv/): ```bash uvx mcp-server-matrix ``` ## Configuration Set environment variables: | Variable | Required | Description | |----------|----------|-------------| | `MATRIX_HOMESERVER` | Yes | Homeserver URL (e.g. `https://matrix.org`) | | `MATRIX_USER` | Yes | Full user ID (e.g. `@bot:matrix.org`) | | `MATRIX_PASSWORD` | Yes* | Account password | | `MATRIX_A…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.