Can I use Matrix as a CLI?

Yes. KosmoKrator exposes a Matrix CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Matrix through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Matrix tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Matrix credentials stored?

Matrix credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Matrix MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

communication

Matrix CLI for Headless Automation

Use the Matrix CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 5 read 2 write Bearer token auth

Submit Matrix feedback View package source

Matrix CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Matrix CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Matrix CLI for Headless Automation
kosmokrator integrations:configure matrix --set access_token="$MATRIX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call matrix.matrix_list_rooms '{"limit":1,"from":"example_from"}' --json

Discovery Before Execution

Agents and scripts can inspect Matrix docs and schemas before choosing a function.

kosmo integrations:docs matrix --json
kosmo integrations:docs matrix.matrix_list_rooms --json
kosmo integrations:schema matrix.matrix_list_rooms --json
kosmo integrations:search "Matrix" --json
kosmo integrations:list --json

Useful Matrix CLI Functions

Function	Type	Parameters	Description
`matrix.matrix_list_rooms`	Read	limit, from	List rooms the authenticated user has joined on Matrix. Returns room IDs, names, and aliases.
`matrix.matrix_get_room`	Read	room_id	Get details of a specific Matrix room, including name, topic, members, and aliases.
`matrix.matrix_create_room`	Write	name, topic, visibility, preset	Create a new room on the Matrix homeserver. Returns the newly created room ID.
`matrix.matrix_send_message`	Write	room_id, body, msgtype, txn_id	Send a text message to a Matrix room. Uses a unique transaction ID to prevent duplicate messages.
`matrix.matrix_list_members`	Read	room_id, limit	List members of a Matrix room. Returns user IDs, display names, and avatar URLs.
`matrix.matrix_get_profile`	Read	user_id	Get a Matrix user's profile information, including display name and avatar URL.
`matrix.matrix_get_current_user`	Read	none	Get the currently authenticated Matrix user's information, including user ID and device ID.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Matrix CLI Pages

CI Matrix CLI for CI. Cron Jobs Matrix CLI for cron jobs. Shell Scripts Matrix CLI for shell scripts. Coding Agents Matrix CLI for coding agents.