Skip to content

Conversation

@mjknowles
Copy link
Contributor

Description

This MR adds a link to my Matrix MCP server that I've built. Functionality right now is limited to read-only type functionality but I will keep expanding upon it. Users can utilize this MCP server to query and interact with the Matrix homeservers via natural language utilizing their favorite MCP client tool(s).

Motivation and Context

This MCP server helps me keep up with the activity on my Matrix server(s) by leveraging natural language and the power of LLMs to summarize and query my chat data.

How Has This Been Tested?

For this specific PR, I have previewed the markdown and LGTM.

For functionality of the actual MCP server, I run my own Matrix homeserver locally and pointed my MCP at it. The MCP server has all the configuration options needed to integrate with the Matrix server's IdP for authentication.

I used Claude Code to install all the tools in the matrix-mcp-server project and then used it to run a full gamut of tests against my own live data.

Breaking Changes

No

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • My changes follows MCP security best practices
  • I have updated the server's README accordingly
  • I have tested this with an LLM client
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Additional context

  • This MCP server utilizes HTTP streaming transport
  • The README includes configuration examples for both Claude Code and vscode.

@mjknowles
Copy link
Contributor Author

Note - I believe this would be classified as a "community server". I have no affiliation with matrix.org. Just a user of the software.

@mjknowles mjknowles changed the title feat: add Matrix MCP server docs: add Matrix MCP server Jul 23, 2025
Copy link
Member

@domdomegg domdomegg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you move this to the community servers section?

domdomegg and others added 2 commits August 17, 2025 16:17
@domdomegg domdomegg merged commit 71f3db8 into modelcontextprotocol:main Aug 17, 2025
19 checks passed
@mjknowles mjknowles deleted the add-matrix-mcp-server branch August 17, 2025 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants