Create a group poll
create_pollMake plans with friends, family, co-workers or any group: create a poll of candidate dates or times, and everyone marks which ones work for them, so the group can find a date or time that works for everyone. For example a dinner, a trip, game night, a team lunch, an offsite or a meeting. Use when the user is planning something with other people and hasn't settled on a date. Returns a link to share with the group and a private link for the organizer. Pass either dates (all-day options) or times (time slots with the user's timeZone), all in the future. Pass organizerName (the user's first name) when you know it. Give the user both links: inviteUrl to share with the group, and manageUrl, which only they should have.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "create_poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dates | No | All-day options as YYYY-MM-DD calendar days. Use this or `times`, not both. | |
| times | No | Time slot options. Use this or `dates`, not both. | |
| title | Yes | What the event is, e.g. "Dinner with Sam and Alex". | |
| duration | No | Default length of each time slot in minutes. Defaults to 60. | |
| location | No | Where it happens, as free text. | |
| timeZone | No | IANA time zone the times are in, usually the user's, like "America/New_York". Required with `times` unless every time has an offset. Each participant sees the times in their own zone. | |
| description | No | More detail for the guests. | |
| organizerName | No | The user's first name, if you know it. The poll shows it as the host. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| pollId | Yes | ||
| options | Yes | ||
| timeZone | Yes | ||
| inviteUrl | Yes | Share this with the group. Anyone with it can vote. | |
| manageUrl | Yes | Private link for the user only: opens the poll to edit it, see results and pick the final date. | |
| nextSteps | Yes |