Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Google Contacts con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
Deja que tu IA trabaje con Google Contacts: busca y lee contactos con correos, teléfonos, empresas y direcciones, crea y actualiza contactos, organiza etiquetas y encuentra a las personas a las que escribiste pero nunca guardaste. Cuentas personales de Google y Google Workspace.
Prueba a pedir
Prompts de ejemplo para Google Contacts
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Google Contacts, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Google Contacts + Claude
Deja que tu IA trabaje con Google Contacts: busca y lee contactos con correos, teléfonos, empresas y direcciones, crea y actualiza contactos, organiza etiquetas y encuentra a las personas a las que escribiste pero nunca guardaste. Cuentas personales de Google y Google Workspace.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Paso 1 — Obtener credenciales
- Abre console.cloud.google.com, elige o crea un proyecto y ve a APIs & Services → Library para activar la Google People API.
- Abre APIs & Services → OAuth consent screen. Elige Internal si usas Google Workspace (la opción más sencilla); si no, External. Con External, pon el estado de publicación en In production: mientras la app está en Testing, Google revoca sus tokens de actualización a los 7 días y el conector deja de funcionar cada semana. Para tu propia cuenta puedes continuar sin más tras el aviso "unverified app".
- Abre APIs & Services → Credentials → Create credentials → OAuth client ID, elige el tipo de aplicación Web application y añade el URI de redirección autorizado
https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugarhttps://tu-host-anythingmcp/api/mcp-oauth/callback. - Pega el ID de cliente en
GOOGLE_CLIENT_IDy el secreto de cliente enGOOGLE_CLIENT_SECRETe instala el conector. - En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta de Google cuyos contactos debe usar la IA. El token de actualización se guarda cifrado y los tokens de acceso se renuevan automáticamente.
Un solo cliente de Google para todos los conectores de Google: el mismo proyecto de Cloud y el mismo cliente OAuth sirven para todos los conectores de Google: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Slides, Google Forms, Google Contacts, Google Meet, Google Tasks, Search Console, Analytics y Ads. Activa cada API en ese proyecto, reutiliza el mismo ID y secreto de cliente y autoriza cada conector una vez. Cada uno pide solo sus propios permisos.
Qué cubre: tus contactos de Google guardados con sus etiquetas, y los "Otros contactos" que Google guarda de las personas a las que escribiste pero nunca guardaste. El conector trabaja como la cuenta de Google que lo autorizó. El directorio de empresa de Google Workspace no está incluido.
Preparar la búsqueda: la búsqueda de contactos de Google funciona sobre una caché. Al empezar una sesión, la IA la actualiza una vez con google_contacts_warm_up_search, espera unos segundos y luego busca. La búsqueda encuentra el inicio de nombres, correos, teléfonos y empresas, por ejemplo ana o acme. Si falta un contacto creado hace unos minutos, la IA vuelve a preparar la búsqueda o lista los contactos modificados más recientemente.
Añadir y actualizar contactos: Google no impide los duplicados, así que la IA busca antes de crear un contacto. Una actualización reemplaza por completo cada campo que nombra: para añadir un segundo teléfono, la IA envía los números existentes junto con el nuevo. Los cambios se envían uno tras otro y pueden tardar unos minutos en aparecer en las listas y en la búsqueda.
Etiquetas y otros contactos: la IA puede crear etiquetas y añadir o quitar contactos; quitar un contacto de una etiqueta no lo elimina. Un "Otro contacto" se puede guardar entre tus contactos con su nombre, correos y teléfonos.
Permisos: el conector pide https://www.googleapis.com/auth/contacts (leer y editar tus contactos y etiquetas) y https://www.googleapis.com/auth/contacts.other.readonly (leer los "Otros contactos"). Los dos son scopes sensibles: fuera de tu propia organización de Workspace, Google muestra el aviso "unverified app" hasta que la app está verificada. Para tu propia cuenta puedes seguir adelante sin problema.
Solo lectura: cambia los scopes en los ajustes OAuth del conector a https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/contacts.other.readonly, vuelve a autorizar y desactiva google_contacts_create_contact, google_contacts_update_contact, google_contacts_create_contact_group, google_contacts_modify_group_members y google_contacts_save_other_contact. Para dejar fuera los "Otros contactos", quita el segundo scope y desactiva google_contacts_list_other_contacts, google_contacts_search_other_contacts y google_contacts_save_other_contact.
Desactivada al instalar: google_contacts_delete_contact. La API no puede recuperar un contacto eliminado, así que actívala solo si la IA debe eliminar contactos.
Los cambios esperan tu confirmación: antes de cada cambio, la IA te muestra el contacto y el cambio, y espera a que confirmes. Los contactos se sincronizan al instante con tu teléfono y con Gmail.
Errores frecuentes: 401 significa que la autorización caducó o se revocó (siempre a los 7 días mientras la pantalla de consentimiento está en Testing): vuelve a hacer clic en Authorize with Provider. 403 PERMISSION_DENIED significa que el scope no permite la llamada, por ejemplo en una configuración de solo lectura o sin el scope de "Otros contactos"; 403 "People API has not been used in project" significa que la Google People API no está activada en el proyecto de Cloud. 404 significa que el id del contacto es incorrecto o que el contacto se eliminó. 400 failedPrecondition al actualizar significa que el contacto cambió mientras tanto: la IA lo vuelve a leer y lo intenta de nuevo.
El conector no lee el directorio de Google Workspace, no sube fotos de contactos y no combina duplicados.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Google Contacts, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
google_contacts_list_contacts | List the user's saved Google Contacts with the fields asked for (names, emails, phones and organizations by default): resourceName, etag… |
google_contacts_get_contact | Read one contact in full: names, emails, phones, organizations, addresses, birthday, notes, websites, relations, events, group memberships… |
google_contacts_search_contacts | Search the user's saved contacts by the start of a name, nickname, email address, phone number or organization, e.g. "ana" or "acme" |
google_contacts_warm_up_search | Refresh the cache behind contact search with the empty request Google asks for, so the next search sees recent changes |
google_contacts_create_contact | Create a contact in the user's Google Contacts (My Contacts) |
google_contacts_update_contact | Change a contact. update_person_fields lists the fields to change, and each listed field is replaced as a whole: to add a second phone… |
google_contacts_delete_contact | Delete a contact from the user's Google Contacts; it disappears from their phone and Gmail too |
google_contacts_list_contact_groups | List the user's contact groups (labels) and the system groups: resourceName, name, formattedName, groupType (USER_CONTACT_GROUP or… |
google_contacts_get_contact_group | Read a contact group (label) with the resourceNames of its members (memberResourceNames), up to max_members |
google_contacts_create_contact_group | Create a contact group (label) with a name |
google_contacts_modify_group_members | Add contacts to a label or remove them from it (up to 1,000 together) |
google_contacts_list_other_contacts | List the user's "Other contacts": people Google saved automatically because the user emailed them, which are not in My Contacts |
google_contacts_search_other_contacts | Search the user's "Other contacts" (people they emailed but never saved) by the start of a name, email address or phone number |
google_contacts_save_other_contact | Save an "Other contact" into My Contacts, copying its name, email addresses and phone numbers |
Ejemplos de prompts
- "¿Cuál es el móvil de Ana García y en qué empresa trabaja?"
- "Añade a Marco Rossi de Acme GmbH a mis contactos: [email protected], +49 761 1234567."
- "Busca a las personas de acme.example a las que escribí pero nunca guardé, y guárdalas en mis contactos."
- "Crea una etiqueta Feria 2026 y añade a todos los contactos de Acme y Globex."
- "Lukas Weber tiene un móvil nuevo, +49 170 5551234. Añádelo a su contacto y conserva el antiguo."
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
¿Te ha sido útil esta guía?
