---
name: "goobook"
section: "1"
platform: "linux"
package: "goobook"
version: "3.5.2-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/goobook"
---

# goobook(1)

access your Google contacts from mutt or the command line

## NAME

goobook - access your Google contacts from mutt or the command line

## SYNOPSIS

**goobook**  \[ options \] COMMAND

## DESCRIPTION

**goobook** can be used to access your Google contacts from the command line. It can also be easily integrated into MUAs such as mutt. It can be used from mutt the same way as abook.

## OPTIONS

- **-h, --help**

  show the help message and exit

- **-c** *FILE,* **--config** *FILE*

  specify alternative configuration file

- **-v, --verbose**

  be verbose about what is going on (stderr)

- **-V, --version**

  print version and exit

- **-d, --debug**

  output debug information to stderr

## COMMAND

- **authenticate**

  Allow goobook to access your Google contacts using OAuth2.

- **add \[NAME\] \[EMAIL\] \[PHONE\]**

  Add a new Google contact. If NAME and EMAIL is not specified, read an email address from stdin and add the From: address to your Google contacts.

- **config-template**

  Display a config template of that can be written to **~/.config/goobookrc**.

- **dump\_contacts**

  dump all your contacts to XML (stdout).

- **dump\_groups**

  dump your contact groups to XML (stdout).

- **dquery QUERY\_STRING**

  Search contacts for QUERY\_STRING, nice vcard like output. QUERY\_STRING is a Python flavoured regexp where all ' ' is replaced with .\*.

- **query \[-s\|--simple\] QUERY\_STRING**

  Search contacts for QUERY\_STRING, mutt compatible plain text output. --simple output format was requested for use with notmuchmail. QUERY\_STRING is a Python flavoured regexp where all ' ' is replaced with .\*.

- **reload**

  Reload contacts from Google and update cache.

## CONFIGURATION

```
For most users it will be enough to run:
goobook authenticate --help
and follow the instructions
```

```
To have access to more advanced options, you can generate a config file by doing:
goobook config-template > ~/.config/goobookrc
```

An example config can look like this:

```
[DEFAULT]
cache_expiry_hours: 24
```

## SEE ALSO

Website: *https://pypi.python.org/pypi/goobook/*

## AUTHOR

This manual page has been written by Dariusz Dwornikowski and Christer Sjöholm