Skip to main content

Sends messages to mattermost's incoming webhooks via CLI

Project description

CLI tool to send messages to the Incoming webhook of mattermost (


usage: mattersend [-h] [-V] [-C CONFIG] [-s SECTION] [-c CHANNEL] [-U URL]
                  [-u USERNAME] [-i ICON]

Sends messages to mattermost's incoming webhooks via CLI

positional arguments:
  message               The message to send or the attachment content if the
                        -a argument is specified. If not specified it will be
                        read from STDIN

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -C CONFIG, --config CONFIG
                        Use a different configuration file
  -s SECTION, --section SECTION
                        Configuration file section
  -c CHANNEL, --channel CHANNEL
                        Send to this channel or @username
  -U URL, --url URL     Mattermost webhook URL
  -u USERNAME, --username USERNAME
  -i ICON, --icon ICON  Icon

Configuration file

The only required option to start sending messages to mattermost is the webhook url. You can either set this in a configurations file (globally in /etc/mattersend.conf or locally in $HOME/.mattersend.conf) or specify it on the CLI with the –url argument.

You can have multiple sections to override DEFAULT settings and later select them from the CLI with the –section argument.

This is an example of a configuration file for mattersend:

url =
icon = :ghost:
username = This is a bot
channel = @myself

icon = :angry:
username = AngryBot

Example usage

echo "Hello world!" | mattersend -U
mattersend -U "Hello world!"


Copyright (c) 2016 Massimiliano Torromeo

mattersend is free software released under the terms of the BSD license.

See the LICENSE file provided with the source distribution for full details.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mattersend-1.1.tar.gz (4.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page