Seven CLI

The seven-cli tool provides you with an efficient solution for sending SMS directly via your console or terminal without any detours. This powerful tool does not require API integration as it works by communicating directly with our gateway via the HTTP API.

You can simply download seven-cli and use it immediately after the download without installation via your command line interface to send SMS messages. The tool is compatible and has been tested with the operating systems Windows XP, Windows 7, macOS, the raspberry pi and Ubuntu.

For individual customization, seven-cli offers two usage modes: you can either pass the required parameters directly as parameters or predefine your settings in the config.ini file. This flexibility makes seven-cli a particularly user-friendly tool for sending SMS messages quickly and easily.


We currently provide compiled builds for Windows, Linux and OSX. If you need seven-cli for another operating system, please send us an e-mail.



Raspberry PI



Required parameters

--apikey Your API key. Create your API key now.

--to recipient of the SMS. Contact names and phone numbers in any format are possible.

--text The text of the SMS.

Optional parameters

--sender Sender of the SMS. This can contain up to 11 alphanumeric or 16 numeric characters.

--flash Sends message as a Flash SMS. These are shown directly on the recipient's display. 1 = Flash SMS / 0 = Normal SMS (default)

--logfile Path to the log file. If the file does not exist, it will be created.

--config Path to the config file. If a parameter is specified as an argument in the call and in the config file, the argument is preferred.

--help Outputs help for the call and the arguments.

--version Display version information of the tool.

Configuration file

Here you can see an example of a configuration file including all available options.

Create API key

[User data]
apikey = "abcdef123456...."    # Gateway API key
logfile = logfile.txt # Name and path of the logfile. Leave empty to deactivate log

# In this area you can enter some default parameters. These are always 
# used if seven-cli is not given the respective parameter 
empfaenger = 49176123456789 # Default recipient or group
flash = 0 # 1 = flash / 0 = no flash
smstext = "Hello world" # SMS text
sender = "Alarm" # Sender of the SMS

[Test alarm]
start = 22:51 # No SMS will be sent within this time window
end = 23:20


seven-cli returns the error level directly as feedback. For example, you can proceed in your batch file depending on whether the SMS transmission was successful.

seven-cli --apikey ... && echo "SMS was sent"


This sends an SMS to 01761234567890 with the text Here is the SMS text and sender CompanyABC. For the sake of simplicity, you can save your user name and your API key in config.ini, for example.

seven-cli \
  --apikey YOUR_API_KEY \
  --to 01761234567890 \
  --text "Here is the SMS text" \
  --sender companyABC


Version 1.7 - 10.04.2020

  • Renamed to seven-cli
  • Parameter SMS type was removed
  • Minor optimizations

Version 1.6 - 28.02.2019

  • Performance optimization especially for mass SMS
  • Parameter --to can now refer to a text file containing the phone numbers
  • SMS type Basic removed

Version 1.5 - 31.01.2019

  • Minor bug fixes when addressing the SMS gateway

Version 1.4 - 28.12.2018

  • Parameter --user no longer required for the SMS API. Please only use your API key.

Version 1.3 - 13.01.2017

  • Adjustments due to the relaunch

Version 1.2 - 16.09.2016

  • The config parameter was added.

Version 1.1 - 07.09.2015

  • Trial alarm times can be set
  • Logfile
  • Debug option
  • Error level

Version 1.0 - 14.05.2015

  • Launch of the tool
Last updated: 3 months ago