---
name: "mc-tool"
section: "1"
platform: "linux"
package: "telepathy-mission-control"
version: "5.16.6-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mc-tool"
---

# mc-tool(1)

manipulate Mission Control accounts from the command line

## NAME

mc-tool - manipulate Mission Control accounts from the command line

## SYNOPSIS

**mc-tool list**

**mc-tool add** *PROFILE* *DISPLAY-NAME*\[*PARAMETER-SETTINGS*...\]

**mc-tool add** *MANAGER*/*PROTOCOL* \[*PARAMETER-SETTINGS*...\]

**mc-tool update** *ACCOUNT* \[*PARAMETER-SETTINGS*...\]

**mc-tool display** *ACCOUNT DISPLAY-NAME*

**mc-tool nick** *ACCOUNT NICKNAME*

**mc-tool service** *ACCOUNT SERVICE-NAME*

**mc-tool icon** *ACCOUNT ICON*

**mc-tool show** *ACCOUNT*

**mc-tool get** *ACCOUNT* *PARAMETER* \[*PARAMETER*...\]

**mc-tool auto-presence** *ACCOUNT* *STATUS* \[*MESSAGE*\]

**mc-tool request** *ACCOUNT* *STATUS* \[*MESSAGE*\]

**mc-tool auto-connect** *ACCOUNT* **on**\|**off**

**mc-tool remove** *ACCOUNT*

## DESCRIPTION

**mc-tool**'s usage depends on its first argument (the "command")

### SPECIFYING ACCOUNTS

Where an account name is needed, it may be given as a full object path (e.g. **/org/freedesktop/Telepathy/Account/gabble/jabber/example**), or as the unique account-specific suffix (e.g. **gabble/jabber/example**).

### SPECIFYING PARAMETER SETTINGS

Many commands take arguments that represent Telepathy connection manager parameters (see the Telepathy Specification for details of these). Each argument has the following form:

*TYPE***:***NAME***=***VALUE*

where *TYPE* is either **int**, **uint**, **bool**, or  **string** (other parameter types exist, but are currently unsupported by **mc-tool**), *NAME* is the name of the connection manager parameter (e.g. **account** or **password**), and *VALUE* is the parameter's value (with integers in decimal, and booleans as **0** or **1**).

The **update** command also accepts arguments of the form **clear:***NAME* which delete the named parameter from the account configuration.

### LIST

**mc-tool list** lists the available accounts.

### ADD

**mc-tool add** adds an account. The connection manager and protocol can either be given as the name of a Mission Control *profile*, (e.g. **gtalk**), or as a slash-separated connection manager name and protocol (e.g. **gabble/jabber**).

### DISPLAY

**mc-tool display** *ACCOUNT DISPLAY-NAME* sets the **DisplayName** property of *ACCOUNT* to *DISPLAY-NAME.*

### NICK

**mc-tool nick** *ACCOUNT NICKNAME* sets the **Nickname** property of *ACCOUNT* to *NICKNAME*.

### SERVICE

**mc-tool service** *ACCOUNT SERVICE-NAME* sets the **Service** property of *ACCOUNT* to *SERVICE-NAME*.

### ICON

**mc-tool icon** *ACCOUNT ICON* sets the **Icon** property of *ACCOUNT* to *ICON*.

### SHOW

**mc-tool show** *ACCOUNT* shows information about *ACCOUNT*.

### GET

**mc-tool get** *ACCOUNT* *PARAMETER* \[*PARAMETER*...\] shows the values of the given parameters of *ACCOUNT*.

### ENABLE

**mc-tool enable** *ACCOUNT* sets the **Enabled** property of *ACCOUNT* to **True**.

### DISABLE

**mc-tool disable** *ACCOUNT* sets the **Enabled** property of *ACCOUNT* to **False**.

### AUTO-PRESENCE

**mc-tool auto-presence** *ACCOUNT* *STATUS* \[*MESSAGE*\] sets the **AutomaticPresence** property of *ACCOUNT* to *STATUS* with optional message *MESSAGE*.

### REQUEST

**mc-tool request** *ACCOUNT* *STATUS* \[*MESSAGE*\] sets the **RequestedPresence** property of *ACCOUNT* to *STATUS* with optional message *MESSAGE*; this is how you tell an account to connect or go offline, for example.

### AUTO-CONNECT

**mc-tool auto-connect** *ACCOUNT* **on** sets the **ConnectAutomatically** property of *ACCOUNT* to **True**. **mc-tool auto-connect** *ACCOUNT* **off** sets it to **False**.