Google Contacts — MCP-сервер для Claude Code
Подключает адресную книгу Google к ассистенту для поиска коллег, редактирования телефонных номеров и управления группами.
claude mcp add --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-contacts -- npx -y google-contacts-mcpЧто делает Google Contacts
MCP-сервер связывает модель с Google People API. Ассистент получает набор инструментов для работы со списком контактов: поиск по именам и телефонам, чтение профилей, создание новых записей, редактирование заметок и обновление контактных данных. Также поддерживается поиск по корпоративному справочнику организации и управление ярлыками групп.
Архитектурно сервер работает как OAuth-прокси. Он не хранит токены или состояние базы у себя, а перенаправляет авторизационные запросы напрямую в сервисы Google.
Без предварительной настройки проекта в Google Cloud Console и включения People API сервер работать не будет. Потребуется сгенерировать OAuth Client ID типа Web application и добавить адрес http://localhost:3000/callback в список разрешённых URI перенаправления.
Какие задачи решает
- найти почту или телефон коллеги по имени и компании
- создать карточку контакта по данным из переписки
- обновить устаревшие сведения и контактные фотографии
- сгруппировать контакты по меткам и спискам рассылки
Примеры запросов агенту
- Найди в контактах Google номер телефона Михаила из отдела безопасности.
- Создай новый контакт: Анна Смирнова, email [email protected], компания Интех.
- Выведи список всех участников группы «Партнёры» в Google Contacts.
Как установить Google Contacts
Командой платформы
claude mcp add --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-contacts -- npx -y google-contacts-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add google-contacts --env GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -- npx -y google-contacts-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"google-contacts": {
"command": "npx",
"args": [
"-y",
"google-contacts-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<GOOGLE_ACCESS_TOKEN>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"google-contacts": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-contacts-mcp"
],
"env": {
"GOOGLE_ACCESS_TOKEN": "<GOOGLE_ACCESS_TOKEN>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> -e MCP_TRANSPORT=<MCP_TRANSPORT> -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> google-contacts npx -y google-contacts-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Contacts
Как установить Google Contacts в Claude Code?
Для установки выполните в терминале команду claude mcp add google-contacts-mcp -e GOOGLE_ACCESS_TOKEN=<GOOGLE_ACCESS_TOKEN> -- npx -y google-contacts-mcp.
Что делает MCP-сервер Google Contacts?
Сервер даёт ассистенту доступ к Google People API. Он позволяет читать карточки людей, искать сотрудников в каталоге компании, менять фотографии профилей и управлять группами контактов.
Какие доступы нужно настроить в Google Cloud для работы сервера?
В Google Cloud Console необходимо активировать People API, настроить экран согласия OAuth и сгенерировать OAuth Client ID для веб-приложения с URI перенаправления http://localhost:3000/callback.
