Skip to content
A command line interface to the macOS Address Book.
Objective-C Roff Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



contacts is a command line interface to the Mac OS X Address Book.


contacts is a quick an easy way to search the OS X Address Book from the command line. An eventual goal is to fully replace the now unmaintained program of the same name. Functionality is currently limited to providing input for a mutt address query and for outputting alias and group entries for mutt.

Example Usage

contacts -m somename

This returns all matches for somename in your address book in a simple format:

name    email

contacts can also output alias and group entries for inclusion in your mutt rc file.See the man file for more detail.

contacts -a --all



make install

Alternately, I'm working on getting this into homebrew, but for now you can install it from my github formula repository (beware of the other formula...).

brew install


As of this time, there is no configuration.

tmux usage

This is not an exhaustive note on how to use with tmux, as I don't use tmux. However, some users have seen success with reattach-to-user-namespace. See I'd suggest installing via brew install reattach-to-user-namespace.


As stated previously, eventually contacts will be a full fledged replacement for the other contacts. For now, it isn't. What it does do is intelligently search your Address Book and format the output so you can use it for the input of a mutt query call.

It is designed to be used with muttqt, a mutt query tool, which wraps contacts as well as manages other address query sources.

Developer Info

contacts is written by Tim Gray. It's obviously inspired by the other contacts.

The contacts homepage can be located on github at

Other contributors

  • Sebastian Tramp - gave me the idea to also search companies.


contacts is released under an Apache License 2.0. Please see the LICENSE.markdown file included with the distribution.

You can’t perform that action at this time.