---
name: polls-for-gmail
description: Create one-click email polls with Polls for Gmail, send them from the user's own email, and report results. Use when the user wants to poll a group, pick a date or time, gather a vote, rating or quick feedback by email, check who is winning a poll, or close one. Requires the Polls for Gmail connector (https://pollsforgmail.com/mcp).
---

# Polls for Gmail

Polls for Gmail makes polls that people answer in one click, right inside the email. You create the poll with the connector's tools, then the email goes out from the user's own email account. Polls for Gmail never emails anyone itself.

## Before anything else

If the `create_poll` tool isn't available, the connector isn't set up. Tell the user to add a custom connector with the URL `https://pollsforgmail.com/mcp` (in Claude: Settings, then Connectors, then Add custom connector) and sign in with Google. A free account is created if they don't have one. Setup help: https://pollsforgmail.com/ai

## Creating a poll

1. Work out the question, the options and who it's for. Ask only for what's missing. Don't invent recipients.
2. Pick the poll type:
   - `single`: pick one (default)
   - `multiple`: pick any. Use this for dates and times, one option per slot, written with day, date, time and timezone, like "Tue Oct 14, 3 to 4 PM ET".
   - `yesno`, `rating` (1 to `rating_max` stars), `ranked`, `text` (written answers)
3. Deadlines: pass `deadline` as ISO 8601 with the user's offset (for example `2026-10-17T17:00:00-04:00`) and `timezone` as an IANA name (for example `America/New_York`) so the email shows the right local time. Use the user's timezone if you know it; otherwise ask.
4. Set `anonymous: true` if the user wants anonymous voting, and `hide_results: true` if voters shouldn't see live results.
5. Confirm the question and options in one short message, then call `create_poll`. Each poll counts toward the user's plan once it gets its first vote, so don't create test polls or duplicates.

If the account can't create a poll (check `get_account` when unsure), say so plainly and share https://pollsforgmail.com/upgrade.

## Sending it

`create_poll` returns `email_html` (the poll card with one-click vote buttons), `email_text` (plain text with one link per option) and `vote_url`.

- If you have an email tool (for example a Gmail connector), create a draft addressed to the recipients. Put `email_html` in the body as HTML, with a short friendly line above it in the user's voice. Show the user the draft and send only after they say so.
- If your email tool only takes plain text, use `email_text`. Every option is still a one-click link.
- With no email tool, give the user `vote_url` and `email_text` to paste into their own email.

Never put the poll in an attachment. The buttons only work in the email body.

## Results and closing

- "How's my poll doing?": call `list_polls` to find it, then `get_poll_results`. Lead with the leader and the vote count, then the breakdown.
- To send the poll to more people, call `get_poll_email` and follow the sending steps above.
- `close_poll` stops voting for good. Confirm with the user first, then share the final results. Offer to email everyone the outcome.

## Recurring polls

If you can run scheduled tasks, you can repeat a poll on a schedule (for example "every Monday at 9am, ask the team where to get lunch"). Create a fresh poll each time rather than resending an old one, and keep the same recipients unless told otherwise.

## Tone

Keep poll questions short and neutral. Keep options parallel and under about 8 where you can. Write emails like a normal person: brief, warm and in the user's voice.
