GMAIL_FORWARD_MESSAGE tool description should note single-recipient limitation (no CC/BCC)

[averyscottapc]

Summary

The GMAIL_FORWARD_MESSAGE tool description does not mention that it only supports a single recipient via the recipient_email parameter, with no support for CC or BCC fields.

This caused our AI agents to incorrectly route email forwarding requests through this tool instead of our internal forwarding tool that supports CC/BCC, resulting in dropped CC recipients.

Expected Behavior

The tool description for GMAIL_FORWARD_MESSAGE should clearly state:

• Only a single recipient is supported (via recipient_email)
• CC and BCC are not supported by this tool
• If CC/BCC functionality is needed, an alternative tool or workflow should be used

Suggested Description Update

Adding a note like:

"Note: This tool supports forwarding to a single recipient only. CC and BCC fields are not available. For multi-recipient forwarding with CC/BCC support, use an alternative approach."

Impact

When AI agents select tools based on descriptions, the absence of this limitation in the description leads to silent failures — emails are forwarded but CC/BCC recipients are silently dropped, which can have significant business consequences.

Environment

• Using Composio SDK with dynamically fetched tool descriptions
• Tool: GMAIL_FORWARD_MESSAGE
• Parameter: recipient_email (single string, no array/list support)

Thank you for considering this update. Happy to provide additional details if helpful.

[Uday-sidagana]

Hey @averyscottapc, we will be updating our tool GMAIL_FORWARD_MESSAGE. I'll keep you updated.