# CommonTime

> Find a meeting time that works for everyone — in 30 seconds. Free group scheduling without back-and-forth. No account required.

CommonTime is a web application for coordinating group meeting times. It moves you from availability polls to a finalized calendar event in one tool.

## Key pages

- [Home](https://commontime.cc): Create a new meeting poll
- [Availability view](https://commontime.cc/r/example): Group heatmap with slot selection
- [MCP install hub](https://commontime.cc/mcp): One-command setup for Codex, Claude Code, and OpenClaw

## How it works

1. Organizer creates a poll and shares the link
2. Participants mark their available hours (no account needed)
3. CommonTime ranks the slots by how many participants are available, with conflict details for each option
4. Organizer finalizes to Google Calendar, Outlook, or Apple Calendar

## Key features

- **Zero login for participants**: No accounts, passwords, or email required
- **Smart slot recommendation**: Ranks options by participant coverage with explicit conflict details
- **Automatic time zones**: Every participant sees times in their own zone
- **Private by default**: No tracking pixels, no ad networks
- **Agent-ready API**: Native MCP tools for AI assistants

## Technical details

- Framework: Next.js 16 (React, Server-Side Rendering)
- Database: Supabase (PostgreSQL)
- Hosting: Google Cloud Run
- Monitoring: Sentry, PostHog

## Quick start for AI agents

Every MCP call requires a Bearer token. Bootstrap one with a single POST — no browser, no OAuth redirect, no human-in-the-loop ceremony.

```bash
# 1. Get an access token (one-shot, no special headers)
TOKEN=$(curl -s -X POST https://commontime.cc/api/agent/install/start \
  -H "Content-Type: application/json" \
  -d '{"clientType":"my-agent","scopes":["poll.read","poll.write"]}' \
  | jq -r .accessToken)

# 2. Use the token on every MCP call
curl -s -X POST https://commontime.cc/api/v1/mcp/messages \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"commontime.create_poll","arguments":{"title":"Team Sync","meetingType":"weekly","duration":60,"selectedDays":[0,1,2,3,4]}}}'
```

`clientType` is free-form — pass your agent's name (`claude`, `codex`, `openclaw`, your-app, etc.). It's recorded for analytics, not enforced as a whitelist. Tokens live ~15 minutes; re-call install/start when expired.

The response contains TWO urls — surface both to the user:

- `inviteUrl` — the participant page. Share it with the people whose availability you need; they vote on this page without any account.
- `editUrl` — the organizer page. Share it ONLY with the user who asked you to create the poll. They use it to manage the poll, see live results, and finalize the meeting.

Never collapse the two into a single link. The user needs to know which to share with whom.

If a participant uses your agent (not the organizer), the same flow works: bootstrap a token, call `commontime.poll.context` with the `pollId` parsed from the inviteUrl to read what dates the organizer set up, optionally call `commontime.compute_availability` to convert the user's calendar busy-intervals into the binary array `vote_poll` expects, then call `commontime.vote_poll`.

## Tools

- [Analytics event schema](https://commontime.cc/api/analytics-schema): JSON Schema for all PostHog funnel events
- [Install endpoint](https://commontime.cc/api/agent/install/start): POST to receive a Bearer token in one shot
- [MCP endpoint](https://commontime.cc/api/v1/mcp/messages): JSON-RPC MCP message endpoint (Authorization: Bearer required)
- [MCP SSE endpoint](https://commontime.cc/api/v1/mcp/sse): event stream for live poll updates

## Optional

- [Full description for AI agents](https://commontime.cc/llms-full.txt): Detailed product description, FAQ, and comparison table
- [OpenAPI specification](https://commontime.cc/openapi.json): OpenAPI 3.0 spec for all agent API endpoints
- [MCP API](https://commontime.cc/.well-known/agent.json): Agent card for AI assistants
- [MCP install schema](https://commontime.cc/.well-known/agent.install.schema.json): Versioned extension schema (`x-commontime-install`)
- Installer policy: download script, verify `.sha256`, then execute (no recommended `curl | bash`)