Matrix Recipes

Ready-to-apply Drupal recipes for Matrix API integration. Each recipe wires up a complete use case — node/comment sync, poll endpoints, identity lookup — with one command.

A collection of Drupal recipes for common Matrix API integration scenarios. Each recipe installs the required modules and imports a ready-to-use ECA configuration so you can go from zero to a working Matrix integration with a single command.

Available recipes

matrix_api_demo Adds Matrix sync to the Article content type. New nodes post to a Matrix room; comments post as thread replies; Matrix thread replies create Drupal comments. matrix_poll_endpoint Creates an ECA endpoint at /eca/matrix/poll

for htmx-triggered polling. POST to this URL to force a Matrix sync before refreshing comment lists.

matrix_identity Installs matrix_api_identity

and adds a demo ECA model: send "whoami" in a Matrix room and the bot replies with your linked Drupal account name.

 

Requirements

Drupal 11.2 or later. The matrix_apimodule and its configuration (homeserver URL, bot token) must be in place before applying a recipe.

How to install

composer require drupal/matrix_recipes
drush recipe recipes/matrix_recipes/matrix_api_demo

Recipes are applied once and can be removed from your codebase afterward — they leave behind only the configuration they imported.

Note on recipes vs. modules

Recipes are not modules. They cannot be enabled or disabled; they are applied once with

drush recipe and do their work. The configuration they import lives in your site's active config and can be edited or deleted like any other Drupal configuration.