Как подключить Google Contacts к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Google Contacts, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Google Contacts + Cursor

Дайте ИИ работать с Google Contacts: искать и читать контакты с адресами почты, телефонами, компаниями и адресами, создавать и обновлять контакты, упорядочивать ярлыки и находить людей, которым вы писали, но так и не сохранили. Личные аккаунты Google и Google Workspace.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Шаг 1 — Получите учётные данные

1. Откройте console.cloud.google.com, выберите или создайте проект, затем перейдите в APIs & Services → Library и включите Google People API.
2. Откройте APIs & Services → OAuth consent screen. Выберите Internal, если вы работаете в Google Workspace (самый простой вариант), иначе External. Для External установите статус публикации In production: пока приложение находится в режиме Testing, Google отзывает его токены обновления через 7 дней, и коннектор перестаёт работать каждую неделю. Для собственной учётной записи предупреждение «unverified app» можно просто пропустить.
3. Откройте APIs & Services → Credentials → Create credentials → OAuth client ID, выберите тип приложения Web application и добавьте разрешённый URI перенаправления https://cloud.anythingmcp.com/api/mcp-oauth/callback. Если вы размещаете AnythingMCP сами, укажите вместо него https://your-anythingmcp-host/api/mcp-oauth/callback.
4. Вставьте идентификатор клиента в GOOGLE_CLIENT_ID, а секрет клиента в GOOGLE_CLIENT_SECRET, затем установите коннектор.
5. На странице коннектора нажмите Authorize with Provider и войдите в аккаунт Google, чьими контактами должен пользоваться ИИ. Токен обновления хранится в зашифрованном виде, токены доступа обновляются автоматически.

Один клиент Google для всех коннекторов Google: один и тот же проект Cloud и клиент OAuth подходят для всех коннекторов Google: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Slides, Google Forms, Google Contacts, Google Meet, Google Tasks, Search Console, Analytics и Ads. Включите каждый API в этом проекте, используйте те же идентификатор и секрет клиента и авторизуйте каждый коннектор один раз. Каждый коннектор запрашивает только свои разрешения.

Что входит: ваши сохранённые контакты Google с ярлыками и «Другие контакты», которые Google заводит для людей, которым вы писали, но так и не сохранили. Коннектор работает от имени аккаунта Google, который его авторизовал. Корпоративный каталог Google Workspace не входит.

Прогрев поиска: поиск контактов Google работает через кеш. В начале сеанса ИИ один раз обновляет его через google_contacts_warm_up_search, ждёт несколько секунд и только потом ищет. Поиск находит совпадения с началом имени, адреса почты, номера телефона или названия компании, например ana или acme. Если контакт, созданный несколько минут назад, всё ещё не находится, ИИ снова прогревает поиск или выводит недавно изменённые контакты.

Добавление и изменение контактов: Google не защищает от дубликатов, поэтому ИИ сначала ищет, а потом создаёт контакт. Обновление полностью заменяет каждое указанное поле: чтобы добавить второй номер телефона, ИИ отправляет существующие номера вместе с новым. Изменения отправляются по одному и могут появиться в списках и поиске через несколько минут.

Ярлыки и другие контакты: ИИ может создавать ярлыки, добавлять в них контакты и убирать их; если убрать контакт из ярлыка, сам контакт останется. «Другой контакт» можно сохранить в свои контакты вместе с именем, адресами почты и номерами телефонов.

Разрешения: коннектор запрашивает https://www.googleapis.com/auth/contacts (чтение и редактирование ваших контактов и ярлыков) и https://www.googleapis.com/auth/contacts.other.readonly (чтение «Других контактов»). Оба scope считаются конфиденциальными: за пределами вашей организации Workspace Google показывает предупреждение «unverified app», пока приложение не прошло проверку. Для собственной учётной записи его можно просто пропустить.

Только чтение: замените scopes в настройках OAuth коннектора на https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/contacts.other.readonly, авторизуйте коннектор заново и отключите google_contacts_create_contact, google_contacts_update_contact, google_contacts_create_contact_group, google_contacts_modify_group_members и google_contacts_save_other_contact. Если «Другие контакты» не нужны, уберите второй scope и отключите google_contacts_list_other_contacts, google_contacts_search_other_contacts и google_contacts_save_other_contact.

Выключен при установке: google_contacts_delete_contact. API не может восстановить удалённый контакт, поэтому включайте его, только если ИИ должен удалять контакты.

Изменения только после вашего «да»: перед каждым изменением ИИ показывает контакт и само изменение и ждёт вашего подтверждения. Контакты сразу синхронизируются с телефоном и Gmail.

Частые ошибки: 401 означает, что авторизация истекла или отозвана (это всегда происходит через 7 дней, пока экран согласия в режиме Testing): снова нажмите Authorize with Provider. 403 PERMISSION_DENIED означает, что scope не разрешает этот вызов, например при настройке только для чтения или без scope для «Других контактов»; 403 «People API has not been used in project» означает, что Google People API не включён в проекте Cloud. 404 означает, что идентификатор контакта неверный или контакт удалён. 400 failedPrecondition при обновлении означает, что контакт тем временем изменился: ИИ читает его заново и повторяет попытку.

Коннектор не читает каталог Google Workspace, не загружает фотографии контактов и не объединяет дубликаты.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Google Contacts.

Доступные инструменты

Примеры запросов

• «Какой мобильный номер у Ana García и в какой компании она работает?»
• «Добавь в контакты Marco Rossi из Acme GmbH: [email protected], +49 761 1234567.»
• «Найди людей с адресами acme.example, которым я писал, но не сохранил, и сохрани их в контакты.»
• «Создай ярлык «Выставка 2026» и добавь в него всех из Acme и Globex.»
• «У Lukas Weber новый мобильный, +49 170 5551234. Добавь его в контакт и оставь старый номер.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse