# Google Contacts

Подключает адресную книгу Google к ассистенту для поиска коллег, редактирования телефонных номеров и управления группами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: domdomegg
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/domdomegg/google-contacts-mcp
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/google-contacts

## Что делает

MCP-сервер связывает модель с Google People API. Ассистент получает набор инструментов для работы со списком контактов: поиск по именам и телефонам, чтение профилей, создание новых записей, редактирование заметок и обновление контактных данных. Также поддерживается поиск по корпоративному справочнику организации и управление ярлыками групп.

Архитектурно сервер работает как OAuth-прокси. Он не хранит токены или состояние базы у себя, а перенаправляет авторизационные запросы напрямую в сервисы Google.

Без предварительной настройки проекта в Google Cloud Console и включения People API сервер работать не будет. Потребуется сгенерировать OAuth Client ID типа Web application и добавить адрес `http://localhost:3000/callback` в список разрешённых URI перенаправления.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GOOGLE_ACCESS_TOKEN`, `MCP_TRANSPORT`, `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- найти почту или телефон коллеги по имени и компании
- создать карточку контакта по данным из переписки
- обновить устаревшие сведения и контактные фотографии
- сгруппировать контакты по меткам и спискам рассылки

## Примеры запросов агенту
- Найди в контактах Google номер телефона Михаила из отдела безопасности.
- Создай новый контакт: Анна Смирнова, email anna@example.com, компания Интех.
- Выведи список всех участников группы «Партнёры» в Google Contacts.

## Похожие
- [Reactive Resume](https://affpapa.org/nevibecode/mcp/reactive-resume.md) — MCP-сервер · ★ 44908
- [screenpipe](https://affpapa.org/nevibecode/mcp/screenpipe.md) — MCP-сервер · ★ 22082
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12826
- [kaneo](https://affpapa.org/nevibecode/mcp/kaneo.md) — MCP-сервер · ★ 9623
- [Mindwtr](https://affpapa.org/nevibecode/mcp/mindwtr.md) — MCP-сервер · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/nevibecode/mcp/azure-devops-ado.md) — MCP-сервер · ★ 2071

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md