Matrix MCP Server

MCP Server for a Matrix home server integration; chat, manage rooms, etc.

Local serverstdioTypeScript

What is the Matrix MCP Server?

MCP Server for a Matrix home server integration; chat, manage rooms, etc.

What you get

A comprehensive Model Context Protocol (MCP) server that provides secure access to Matrix homeserver functionality. Built with TypeScript, this server enables MCP clients to interact with Matrix rooms, messages, users, and more through a standardized interface.

  • 🔐 OAuth 2.0 Authentication with token exchange support
  • 📱 15 Matrix Tools organized by functionality tiers
  • 🏠 Multi-homeserver Support with configurable endpoints
  • 🔄 Real-time Operations with ephemeral client management
  • 🚀 Production Ready with comprehensive error handling
  • 📊 Rich Responses with detailed Matrix data

Configuration and credentials

  • Node.js 20+ and npm - Matrix homeserver access (Synapse, Dendrite, etc.) - MCP client (Claude Desktop, VS Code with MCP extension, etc.)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Configuration

  • Node.js 20+ and npm - Matrix homeserver access (Synapse, Dendrite, etc.) - MCP client (Claude Desktop, VS Code with MCP extension, etc.)
VariableDescriptionRequired
SSL_KEY_PATHCredential the server authenticates with.Yes
SSL_CERT_PATHFilesystem location the server is allowed to use.Optional
IDP_ISSUER_URLEndpoint or connection string the server talks to.Yes
IDP_AUTHORIZATION_URLEndpoint or connection string the server talks to.Yes
IDP_TOKEN_URLCredential the server authenticates with.Yes
OAUTH_CALLBACK_URLEndpoint or connection string the server talks to.Yes
MATRIX_HOMESERVER_URLEndpoint or connection string the server talks to.Yes
MATRIX_CLIENT_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use Matrix to Prerequisites.”
  • “Use Matrix to Installation.”

Frequently asked questions

OAuth mode uses full OAuth 2.0 integration with your identity provider, supports token exchange for Matrix homeserver authentication, and is recommended for production deployments.