# Message Send

Gmail

Send a new message from a connected Gmail mailbox.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Message Send (tool ID: gmail.message-send). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Send email from Gmail](https://scrollport.com/tools/gmail-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Sends one structured Gmail message with optional bounded private attachments. Sending is externally visible and cannot be undone. It can optionally join an existing thread. Always one upstream request at $0.0025.

**Inputs and outputs**

### Input

`body` object · required

Bounded request body sent to the connected application.

### Output

`id` string

Returned id value.

`labelIds` array

Returned label ids value.

`threadId` string

Returned thread id value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "gmail.message-send",
  "input": {
    "body": {
      "email": {
        "to": [
          "hello@scrollport.com"
        ],
        "from": "alan.v20x@gmail.com",
        "text": "This test confirms ScrollPort can send email using the connected Gmail account.",
        "subject": "ScrollPort Gmail evidence test"
      }
    }
  }
}
```

### Output

```
{
  "id": "18f0sentmessage456",
  "labelIds": [
    "SENT"
  ],
  "threadId": "18f0sentthread456"
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own Gmail mailbox, which isn't connected yet.Open connect_url, approve permission to send Gmail messages, then retry this run unchanged.
- `invalid_input`: The structured email is missing its authorised sender, recipients, subject, or content.Provide body.email.from, to, subject, and text, html, or both. Attachments must use private ScrollPort artifact URLs.

---

Canonical page: https://scrollport.com/tools/providers/gmail/message-send