# google-contacts-mcp-server

MCP server with google-contacts integration

This MCP server was generated using the Template Orchestrator and includes the following integrations:

## Available Tools

This MCP server provides 18 tools across 1 integrations:

### GoogleContacts Tools
- **google-contacts_create_contact**: Create a new contact with specified fields
- **google-contacts_get_person**: Get a specific contact by resource name
- **google-contacts_update_contact**: Update an existing contact
- **google-contacts_delete_contact**: Delete a contact permanently
- **google-contacts_list_connections**: List authenticated user's contacts
- **google-contacts_search_contacts**: Search across all contacts with text query
- **google-contacts_batch_get_people**: Get multiple contacts by resource names
- **google-contacts_list_contact_groups**: List all contact groups
- **google-contacts_create_contact_group**: Create a new contact group
- **google-contacts_get_contact_group**: Get a specific contact group by resource name
- **google-contacts_update_contact_group**: Update an existing contact group
- **google-contacts_delete_contact_group**: Delete a contact group
- **google-contacts_modify_contact_group_members**: Add or remove members from a contact group
- **google-contacts_list_directory_people**: List people in the authenticated user's domain directory (G Suite/Workspace)
- **google-contacts_search_directory_people**: Search people in the authenticated user's domain directory
- **google-contacts_list_other_contacts**: List other contacts (auto-created contacts from interactions)
- **google-contacts_search_other_contacts**: Search other contacts with text query
- **google-contacts_copy_other_contact**: Copy an other contact to the authenticated user's contacts

## Installation

```bash
npm install @coretext-ai/qa-google-contacts-a58500d5-8331-4ce9-a140-d204a9fae815
```

## Environment Setup

Create a `.env` file with the following variables:

```env
GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here
```

## Usage

### Running the server

```bash
# Development mode
npm run dev

# Production mode
npm run build && npm start
```

### Using with Claude Desktop

Add this to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "google-contacts-mcp-server": {
      "command": "npx",
      "args": ["@coretext-ai/qa-google-contacts-a58500d5-8331-4ce9-a140-d204a9fae815"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here"
      }
    }
  }
}
```

## Instructions for Fetching API Keys/Tokens
- **COMING SOON**

## Generated Information

- **Generated at**: Thu Jul 24 2025 03:00:19 GMT+0000 (Coordinated Universal Time)
- **Orchestrator version**: 0.0.2
- **Template repository**: Coretext-AI-Dev/server-template-v2
- **Total endpoints**: 18