This project is a server that lets you manage your Google Contacts using simple commands. MCP stands for "Model Context Protocol," which is a special kind of server that makes it easy to interact with APIs like the Google People API.
This server provides a set of "tools" that you can use to do things like:
First, you need to install the necessary libraries. You can do this by running the following command in your terminal:
pip install -r requirements.txtTo use this server, you need to give it permission to access your Google Account. This is done using a special token. The server expects this token to be provided when you use a tool that requires it.
You can start the server by running the following command in your terminal:
python server.pyYou can also specify the transport, host, and port if needed.
Here are the tools you can use with this server:
These tools help you manage your individual contacts.
get_person: Gets information about a specific person in your contacts.list_connections: Lists all of your contacts.create_contact: Creates a new contact.update_contact: Updates an existing contact's information.delete_contact: Deletes a contact.search_contacts: Searches for contacts that match a query.These tools are for organizing your contacts into groups.
list_contact_groups: Lists all of your contact groups.get_contact_group: Gets information about a specific contact group.create_contact_group: Creates a new contact group.update_contact_group: Updates an existing contact group.delete_contact_group: Deletes a contact group.batch_get_contact_groups: Gets information about multiple contact groups at once."Other contacts" are people you've interacted with on Google services that are saved automatically. These tools help you manage them.
list_other_contacts: Lists all of your "Other contacts".search_other_contacts: Searches through your "Other contacts".copy_other_contact_to_my_contacts_group: Copies a contact from "Other contacts" to your main contacts list.