# Matrix Notify

> Send messages to Matrix (Element) chat rooms. Support for text, markdown, HTML, images, and file attachments.

- Skill: `winsorllc/matrix-notify` (Agent Skill)
- Install (CLI): `npx skillmds@latest add winsorllc/matrix-notify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/winsorllc/matrix-notify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: winsorllc (https://skillmd.com/u/winsorllc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/winsorllc/matrix-notify

---


# Matrix Notify — Matrix Protocol Messaging

Send messages to Matrix (Element) chat rooms with support for rich formatting and file uploads.

## Overview

This skill provides:
- **Text Messages**: Plain text, markdown, and HTML
- **Rich Content**: Images, files, and code blocks
- **Room Management**: Join, leave, and list rooms
- **Thread Support**: Reply to specific messages
- **Typing Indicators**: Show typing status
- **Read Receipts**: Mark messages as read

## Configuration

```json
{
  "homeserver": "https://matrix.org",
  "access_token": "YOUR_ACCESS_TOKEN",
  "default_room": "!roomid:matrix.org"
}
```

## API

```javascript
const { sendMessage, uploadFile } = require('./matrix-notify');

// Send text message
await sendMessage({
  room: '!roomid:matrix.org',
  text: 'Hello from PopeBot!',
  format: 'markdown'
});

// Send image
await uploadFile({
  room: '!roomid:matrix.org',
  file: '/path/to/image.png',
  caption: 'Check this out'
});
```

## CLI

```bash
matrix-notify send --room "!roomid:matrix.org" --text "Hello!"
matrix-notify upload --room "!roomid:matrix.org" --file image.png
matrix-notify rooms
```