coretext-contacts-mcp-server

Coretext Contacts MCP Server

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_get_person: Get a specific contact by resource name
• google-contacts_create_contact: Create a new contact with specified fields
• google-contacts_delete_contact: Delete a contact permanently
• google-contacts_update_contact: Update an existing contact. IMPORTANT: Include the 'etag' field in the request body to prevent conflicts. Get the current etag by first calling get_contact or from a previous create/update response.
• 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_connections: List authenticated user's contacts
• google-contacts_get_contact_group: Get a specific contact group by resource name
• google-contacts_copy_other_contact: Copy an other contact to the authenticated user's contacts
• google-contacts_list_contact_groups: List all contact groups
• google-contacts_list_other_contacts: List other contacts (auto-created contacts from interactions)
• google-contacts_create_contact_group: Create a new contact group
• google-contacts_delete_contact_group: Delete a contact group
• google-contacts_update_contact_group: Update an existing contact group. IMPORTANT: Include the 'etag' field in the contactGroup object to prevent conflicts. Get the current etag by first calling get_contact_group or from a previous create/update response.
• google-contacts_list_directory_people: List people in the authenticated user's domain directory (G Suite/Workspace). TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly
• google-contacts_search_other_contacts: Search other contacts with text query
• google-contacts_search_directory_people: Search people in the authenticated user's domain directory. TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly
• google-contacts_modify_contact_group_members: Add or remove members from a contact group

Installation

npm install @coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509

Environment Setup

Create a .env file with the following variables:

GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here

Usage

Running the server

# Development mode
npm run dev

# Production mode
npm run build && npm start

Using with Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "coretext-contacts-mcp-server": {
      "command": "npx",
      "args": ["@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here"
      }
    }
  }
}

Instructions for Fetching API Keys/Tokens

• COMING SOON

Advanced Features

Request Cancellation

This MCP server supports request cancellation according to the MCP cancellation specification. Clients can cancel in-progress requests by sending a notifications/cancelled message with the request ID.

When a request is cancelled:

• The server immediately stops processing the request
• Any ongoing API calls are aborted
• Resources are cleaned up
• No response is sent for the cancelled request

Progress Notifications

The server supports progress notifications for long-running operations according to the MCP progress specification.

To receive progress updates:

1. Include a progressToken in your request metadata
2. The server will send notifications/progress messages with:
   • Current progress value
   • Total value (when known)
   • Human-readable status messages

Progress is reported for:

• Multi-step operations
• Batch processing
• Long-running API calls
• File uploads/downloads

Example progress notification:

{
  "method": "notifications/progress",
  "params": {
    "progressToken": "operation-123",
    "progress": 45,
    "total": 100,
    "message": "Processing item 45 of 100..."
  }
}

Generated Information

• Generated at: Thu Oct 23 2025 14:54:39 GMT+0000 (Coordinated Universal Time)
• Orchestrator version: 0.0.2
• Template repository: Coretext-AI-Dev/server-template-v2
• Total endpoints: 18