The problem it resolves
Give an AI client a precise mailbox to operate
When a mailbox task depends on the right message, thread, label, or attachment, a broad instruction is not enough. MCP Abilities – Google Workspace exposes registered WordPress abilities for one impersonated Workspace mailbox, so the client can work against a named Gmail object and return the resulting operation state.
The plugin carries out the requested operation. The authorized operator still decides what to inspect, change, or send, including whether an outbound message is appropriate.
Decisions that protect the mailbox
Three boundaries keep each operation accountable
Use these rules to separate setup, object selection, and the point at which Gmail state changes.
01
Configure one delegated identity
Use raw service account JSON, never a local file path. Configuration validates the client email and private key, saves the settings, and tests authentication for one impersonated Workspace mailbox.
02
Check the connection before use
Set up domain-wide delegation with the required read, send, modify, and label scopes, then check whether the mailbox is configured and connected before using it.
03
Treat targets and changes as exact
Use the relevant message, thread, attachment, or label identifier where required. Label changes, mailbox-state shortcuts, sends, and replies apply immediately without a separate confirmation stage.
A practical route from setup to action
Connect the mailbox, inspect the target, then act
This is recommended operator practice. The abilities perform the named operations; the operator owns the decision to proceed.
01
Authorize the delegated mailbox
Set up a Google service account with domain-wide delegation and grant the required read, send, modify, and label scopes for the intended Workspace mailbox.
02
Configure and check status
Submit the raw service account JSON and the impersonated mailbox. Configuration validates and tests authentication; status then reports whether the connection is configured and connected.
03
Inspect before changing
Search and page through messages or threads, list labels, or retrieve an exact message, thread, label, or attachment. Confirm the returned identifiers and account context before selecting a mutation or outbound action.
04
Apply one explicit operation
Use the exact message, label, thread, recipient, subject, and body fields for the chosen operation, then read the returned state. Gmail sends, replies, label changes, and mailbox-state shortcuts take effect immediately.
Read first, decide second
Find the message, thread, or attachment you actually mean
Separate mailbox discovery from inspection so the chosen object and any mark-read effect stay explicit.
Search messages
Search Gmail messages and page through the results to identify candidate messages.
Search threads
Search Gmail threads and page through the results when the conversation, rather than one message, is the working unit.
Inspect one message
Retrieve one exact message by its identifier. Mark it read only when that option is explicitly requested.
Inspect one thread
Retrieve one exact thread by its identifier so a decision or reply has the right conversation context.
Retrieve one attachment
Retrieve one exact attachment using the identifier returned by the relevant Gmail object. Set the response limit from 1 byte to 20 MB.
Keep labels deliberate
Administer Gmail labels without losing the target
Inspect labels separately from changing them. Every mutation names one exact label and applies immediately.
List labels
List system and user labels to see the available label identifiers before acting.
Inspect one label
Retrieve one exact label to confirm its current name, visibility, and other returned state.
Create one label
Create a label with the supplied name, visibility, and optional color fields.
Update one label
Update one exact label using its identifier and the fields you intend to change.
Delete one label
Delete one exact label identifier. Deletion is immediate and has no separate confirmation stage.
Mailbox state
Change one message without losing its target
For one exact Gmail message, the mailbox-state operation adds or removes specified labels. Its explicit shortcuts mark that message read or unread, archive it, or move it to trash.
These changes happen immediately and do not add a separate confirmation stage. Select the message identifier and intended state explicitly, then inspect Gmail’s returned state. An authenticated WordPress user with manage_options is required.
Choose the outbound path
Send from the transport that matches the message
Each path uses the target and content you specify. A successful call sends immediately, and these abilities do not add a separate confirmation stage.
Send through Gmail
Send a new message through the configured Gmail identity. Supply the exact recipient, subject, and body, with optional CC and BCC recipients.
Reply in Gmail
Reply to one exact existing message and thread with the requested body. Reply all is disabled unless it is explicitly requested.
Send through WordPress mail
Use the site’s WordPress mail transport when that is the required delivery path. It remains separate from the configured Gmail identity.
Required runtime
Dependencies for MCP Abilities – Google Workspace
Keep these source-owned dependencies available at their authoritative destinations.
WordPress 6.9 or later
WordPress 6.9+Provides the WordPress runtime and registered Abilities API.
PHP 8.0 or later
PHP 8.0+Provides the required server runtime.
Active WordPress Abilities API
WordPress Abilities APIOwns ability registration, schemas, annotations, and authorization callbacks.
Active MCP Adapter
WordPress MCP AdapterExposes registered WordPress abilities to authenticated MCP clients.
Active MCP Expose Abilities plugin
MCP Expose AbilitiesProvides the Devenia transport policy for the registered abilities.
Enabled for the delegated Workspace identity
Google Workspace Gmail APIProvides the mailbox, message, thread, attachment, label, and sending operations used through the configured Workspace identity.
Make the mailbox useful
Download MCP Abilities – Google Workspace and connect one mailbox
Download the stable self-hosted package to give an AI client a WordPress route to one configured Google Workspace mailbox. The next useful check is whether that delegated connection is configured and connected.