send_draft
Send pre-written email drafts directly from Gmail MCP using the draft ID. Simplify email workflows by eliminating manual steps in finalizing and dispatching messages.
Instructions
Send an existing draft
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the draft to send |
Implementation Reference
- src/index.ts:376-385 (handler)Handler function for the 'send_draft' tool. Sends the specified draft using the Gmail API by calling gmail.users.drafts.send. Includes error handling for cases like missing recipients. Uses shared handleTool for authentication.
async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { try { const { data } = await gmail.users.drafts.send({ userId: 'me', requestBody: { id: params.id } }) return formatResponse(data) } catch (error) { return formatResponse({ error: 'Error sending draft, are you sure you have at least one recipient?' }) } }) } - src/index.ts:373-375 (schema)Input schema for the 'send_draft' tool, defining the required 'id' parameter as a string (draft ID).
{ id: z.string().describe("The ID of the draft to send") }, - src/index.ts:371-386 (registration)Registration of the 'send_draft' tool using server.tool(), including description, input schema, and inline handler function.
server.tool("send_draft", "Send an existing draft", { id: z.string().describe("The ID of the draft to send") }, async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { try { const { data } = await gmail.users.drafts.send({ userId: 'me', requestBody: { id: params.id } }) return formatResponse(data) } catch (error) { return formatResponse({ error: 'Error sending draft, are you sure you have at least one recipient?' }) } }) } ) - src/index.ts:50-80 (helper)Shared helper function 'handleTool' used by send_draft (and other tools) to handle OAuth2 authentication, validate credentials, create Gmail client, execute the API call, and handle errors appropriately.
const handleTool = async (queryConfig: Record<string, any> | undefined, apiCall: (gmail: gmail_v1.Gmail) => Promise<any>) => { try { const oauth2Client = queryConfig ? createOAuth2Client(queryConfig) : defaultOAuth2Client if (!oauth2Client) throw new Error('OAuth2 client could not be created, please check your credentials') const credentialsAreValid = await validateCredentials(oauth2Client) if (!credentialsAreValid) throw new Error('OAuth2 credentials are invalid, please re-authenticate') const gmailClient = queryConfig ? google.gmail({ version: 'v1', auth: oauth2Client }) : defaultGmailClient if (!gmailClient) throw new Error('Gmail client could not be created, please check your credentials') const result = await apiCall(gmailClient) return result } catch (error: any) { // Check for specific authentication errors if ( error.message?.includes("invalid_grant") || error.message?.includes("refresh_token") || error.message?.includes("invalid_client") || error.message?.includes("unauthorized_client") || error.code === 401 || error.code === 403 ) { return formatResponse({ error: `Authentication failed: ${error.message}. Please re-authenticate by running: npx @shinzolabs/gmail-mcp auth`, }); } return formatResponse({ error: `Tool execution failed: ${error.message}` }); } } - src/index.ts:48-48 (helper)Helper function 'formatResponse' used to standardize tool responses in MCP format.
const formatResponse = (response: any) => ({ content: [{ type: "text", text: JSON.stringify(response) }] })