matrix-mcp-server
About
MCP Server for a Matrix home server integration; chat, manage rooms, etc.
Details
- Author
- mjknowles
- GitHub stars
- 48
- Downloads
- 611
- Categories
- Other
Jump to
- 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
- Comprehensive error handling and input validation
- Rich responses with detailed Matrix data
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
matrix-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies via npm, build the project, configure environment variables in a .env file, and start the server with npm start. Clients connect via HTTP transport, providing headers for Matrix user ID, homeserver URL, and access token (or OAuth). The server offers two authentication modes: OAuth mode for production and development mode for testing.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"matrix-mcp-server": {
"matrix-mcp-server": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector"
]
}
}
}
}McpServers
{
"matrix-mcp-server": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector"
]
}
}Matrix MCP Server
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.
Features
- 🔐 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
Quick Start
Prerequisites
- Node.js 20+ and npm
- Matrix homeserver access (Synapse, Dendrite, etc.)
- MCP client (Claude Desktop, VS Code with MCP extension, etc.)
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
