Gmail API integration for Google Workspace via MCP.

Tested up to: 6.9 Stable tag: 2.0.6 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

This add-on plugin provides Gmail API integration through MCP (Model Context Protocol) for Google Workspace accounts. Your AI assistant can send emails, read inbox messages, reply to threads, and manage labels. Personal Gmail accounts are not supported.

Concrete example: your support inbox receives refund and invoice emails all day. With this plugin, an AI assistant can read unread billing messages, draft or send a reply in the same thread, label the message as handled, and archive it without you opening Gmail.

Part of the MCP Expose Abilities ecosystem.

• WordPress 6.9+
• PHP 8.0+
• Abilities API plugin
• MCP Adapter plugin
• Google Workspace with service account (domain-wide delegation). Personal Gmail accounts are not supported.

1. Install the required plugins (Abilities API, MCP Adapter)
2. Download the latest release from Releases
3. Upload via WordPress Admin > Plugins > Add New > Upload Plugin
4. Activate the plugin
5. Configure Google Workspace Gmail API credentials (see Setup below)

1. Go to Google Cloud Console
2. Create a project or select existing
3. Enable Gmail API
4. Create service account with domain-wide delegation
5. Download JSON key file

In Google Workspace Admin:

1. Go to Security > API controls > Domain-wide delegation
2. Add the service account client ID
3. Add scopes:
   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/gmail.send
   • https://www.googleapis.com/auth/gmail.modify
   • https://www.googleapis.com/auth/gmail.labels

Use gmail/configure ability to set up credentials. The service_account_json parameter must be raw JSON content (not a file path).

{
  "ability_name": "gmail/configure",
  "parameters": {
    "service_account_json": "{...raw service account JSON...}",
    "impersonate_email": "user@yourdomain.com"
  }
}

{
  "ability_name": "gmail/send",
  "parameters": {
    "to": "recipient@example.com",
    "subject": "Meeting Tomorrow",
    "body": "<p>Hi,</p><p>Just confirming our meeting tomorrow at 2 PM.</p>",
    "html": true
  }
}

{
  "ability_name": "gmail/list",
  "parameters": {
    "max_results": 10,
    "label": "INBOX"
  }
}

{
  "ability_name": "gmail/reply",
  "parameters": {
    "thread_id": "abc123",
    "body": "Thanks for the update!"
  }
}

{
  "ability_name": "gmail/modify",
  "parameters": {
    "id": "message123",
    "remove_labels": ["INBOX"]
  }
}

1. List unread support emails:

{
  "ability_name": "gmail/list",
  "parameters": {
    "label": "INBOX",
    "q": "is:unread subject:(invoice OR billing OR refund)",
    "max_results": 5
  }
}

2. Get the full message content for the top hit:

{
  "ability_name": "gmail/get",
  "parameters": {
    "id": "MESSAGE_ID_FROM_LIST"
  }
}

3. Reply in the same thread:

{
  "ability_name": "gmail/reply",
  "parameters": {
    "thread_id": "THREAD_ID_FROM_GET",
    "body": "Hi! Thanks for contacting us. I have checked your invoice and processed the correction. You will receive the updated receipt shortly."
  }
}

4. Label and archive the handled message:

{
  "ability_name": "gmail/modify",
  "parameters": {
    "id": "MESSAGE_ID_FROM_LIST",
    "add_labels": ["Label_1234567890"],
    "remove_labels": ["INBOX", "UNREAD"]
  }
}

• Uses Google service accounts (no user passwords stored)
• Domain-wide delegation controlled by Workspace admin
• Scopes limited to Gmail API operations only
• All operations require WordPress authentication

• Docs: expanded the WordPress-standard readme.txt so the published ZIP now includes fuller requirements, setup guidance, use cases, and Devenia ecosystem links

• Security: gmail/configure now accepts raw JSON only (no file path reads)
• Docs: sync stable tag and parameter examples with current behavior

• Fixed: Removed hard plugin header dependency on abilities-api to avoid slug-mismatch activation blocking

• Cache config access and tighten API response handling

• Reduce readme tags to 5 for plugin check compliance

• Rename plugin to Google Workspace (repo + folder + docs)

• Clarify Google Workspace-only support (service accounts, domain-wide delegation)

• Initial release

GPL-2.0+

Devenia - We've been doing SEO and web development since 1993.

• Plugin Page
• Core Plugin (MCP Expose Abilities)
• All Add-on Plugins