Skip to content
proton-cli
Menu
DocsCommandsFAQStats
Start here
InstallFirst commandsHow a command is builtManaging proton itself
Everyday use
Naming what to act onFilters and bulk changesDry runs and confirmationsOutput and exit codesScriptingAI agentsSettings, files and environment
When something goes wrong
TroubleshootingWhat it can't do
Account
Guideproton accountproton account keysproton account sessionsproton account security-logproton account breachesproton account profilesproton account settings
Mail
Guideproton mail messagesproton mail conversationsproton mail draftsproton mail mailing-listsproton mail protectedproton mail settings
Drive
Guideproton drive itemsproton drive trashproton drive photosproton drive computersproton drive sharingproton drive linksproton drive sharedproton drive invitationsproton drive settingsproton drive volumes
Calendar
Guideproton calendar eventsproton calendar busy-timesproton calendar booking-pagesproton calendar remindersproton calendar invitationsproton calendar settings
Pass
Guideproton pass itemsproton pass vaultsproton pass aliasesproton pass linksproton pass sharingproton pass sharedproton pass invitationsproton pass trashproton pass breachesproton pass settingsimport, export, generate
Contacts
Guideproton contactsproton contacts emailsproton contacts groupsproton contacts keys
Local index
Guideproton index
Raw API
Guideproton api
About
FAQSecurityAll commandsChangelogProton API reference

proton contacts groups

Contact groups.

Every command under proton contacts groups, with the arguments and flags it takes. For these commands in use, see the contacts guide.

Holds add, create, delete, get, list, remove and update.

add

Section titled “add”

Add contacts to a group.

Proton groups addresses rather than people, so a colleague’s work address can be in a group while their personal one is not. Naming a contact means all of their addresses, and naming one of their addresses means that one.

proton contacts groups add REF CONTACT_REF...
Terminal window
proton contacts groups add Team jane

create

Section titled “create”

Create a contact group.

proton contacts groups create
Terminal window
proton contacts groups create --name Team
proton contacts groups create --name Family --color strawberry
Flag Description
--color string Accent color, by name (purple) or hex (#8080FF) (default #8080FF)
--name string Group name

delete

Section titled “delete”

Delete contact groups.

proton contacts groups delete REF...
Terminal window
proton contacts groups delete Team

get

Section titled “get”

Show one group and the addresses in it.

proton contacts groups get REF
Terminal window
proton contacts groups get Team

list

Section titled “list”

List contact groups.

proton contacts groups list
Terminal window
proton contacts groups list
Flag Description
--desc Reverse the order
--limit int How many groups per page; 0 for all of them
--page int Which page of results, counting from zero
--sort string Order by: name (default name)

remove

Section titled “remove”

Remove contacts from a group.

Proton groups addresses rather than people, so a colleague’s work address can be in a group while their personal one is not. Naming a contact means all of their addresses, and naming one of their addresses means that one.

proton contacts groups remove REF CONTACT_REF...
Terminal window
proton contacts groups remove Team jane

update

Section titled “update”

Rename or recolor a contact group.

proton contacts groups update REF
Terminal window
proton contacts groups update Team --name Engineering
proton contacts groups update Team --color reef
Flag Description
--color string New accent color, by name (purple) or hex (#8080FF)
--name string New group name

Every command also takes the flags that work everywhere.