MCP tools: contacts

Search, create, and update contacts and mailing lists over MCP. write tools need ATBRIDGE_ALLOW_WRITES=1 — see the MCP overview.

Tool	Access	Purpose	Key parameters
contacts_books	read	List address books	—
contacts_list	read	List contacts (lean rows by default)	limit, verbose
contacts_search	read	Search contacts across all fields (name, emails, phone, org, title, address, note)	query (optional — omit to list all), limit, verbose
contacts_show	read	One contact’s details	identifier
contacts_lists	read	List mailing lists / groups	book (optional)
contacts_list_members	read	Members of a mailing list	list (id or name)
contacts_create	write	Create a contact	book_id, properties
contacts_update	write	Update a contact	identifier, properties
contacts_delete	write	Delete a contact	identifier
contacts_list_create	write	Create a mailing list / group	book_id, name, nick_name, description
contacts_list_add	write	Add a contact to a list	list (id or name), contact (card id)
contacts_list_remove	write	Remove a contact from a list	list, contact
contacts_list_delete	write	Delete a mailing list (contacts kept)	list (id or name)