@mcp-utilities/communication

MCP Communication tools for email and WhatsApp messaging.

Features

• Email Communication: Send professional emails via Gmail API with OAuth2 authentication
• WhatsApp Communication: Send WhatsApp messages via WhatsApp Business API
• File Attachments: Support for various file formats in both email and WhatsApp
• HTML Formatting: Rich email content with HTML formatting
• Template Support: WhatsApp template messages with dynamic parameters

Installation

npm install @mcp-utilities/communication

Usage

As a Package

import CommunicationPackage from '@mcp-utilities/communication';

// Initialize with configuration
await CommunicationPackage.initialize({
  oauth: {
    clientId: 'your_gmail_oauth_client_id',
    clientSecret: 'your_gmail_oauth_client_secret',
    accessToken: 'your_access_token',
    refreshToken: 'your_refresh_token'
  },
  whatsapp: {
    token: 'your_whatsapp_api_token',
    url: 'https://graph.facebook.com/v18.0/YOUR_PHONE_NUMBER_ID/messages'
  }
});

// Get available tools
const tools = CommunicationPackage.tools;

// Call a tool
const result = await CommunicationPackage.callTool('mail_communication', {
  subject: 'Test Email',
  content: '<h1>Hello</h1><p>This is a test email.</p>',
  recipient: ['[email protected]']
});

Available Tools

mail_communication

Send formal emails with HTML content support, CC, and BCC capabilities.

Parameters:

• subject (string): Email subject line (max 100 characters)
• content (string): HTML email content with formatting support
• recipient (array): Main recipient email addresses
• cc (array, optional): Carbon copy recipients
• bcc (array, optional): Blind carbon copy recipients
• attachment_paths (array, optional): File paths to attachments

whatsapp_communication

Send quick WhatsApp messages to individual recipients.

Parameters:

• content (string): Plain text message content
• recipient (string): WhatsApp phone number (E.164 or local format)
• attachment_path (string, optional): File path to attachment

Configuration

Gmail OAuth Setup

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable the Gmail API
4. Create OAuth 2.0 credentials (Desktop application)
5. Set authorized redirect URIs: http://localhost:3000/oauth2callback

WhatsApp Business API Setup

1. Set up WhatsApp Business API account
2. Create a message template named "whatsapp_template"
3. Get your phone number ID and access token

Dependencies

• @modelcontextprotocol/sdk: MCP protocol support
• googleapis: Gmail API integration
• google-auth-library: OAuth2 authentication
• axios: HTTP client for WhatsApp API
• form-data: File upload support
• pdfkit: PDF generation
• mime-types: MIME type detection

License

MIT License