Ask your AI who's signed up for Thursday. Ask which of your regulars hasn't played since June. It can answer both, along with most of the questions you'd normally dig through your pickleball sessions to work out, once you connect it to your Pickleheads account.
That link is called an MCP connector: a secure connection between your AI tool and your Pickleheads account. It lets your AI read your data when you ask, and, if you allow it, set up and manage sessions for you. Setup takes about a minute. Here's how to do it in Claude, in ChatGPT, and in everything else that speaks MCP.
Here's the MCP address that you'll need to connect to your AI tools.
👉 https://mcp.pickleheads.com/mcp
At a glance
- Server address: https://mcp.pickleheads.com/mcp
- Connection type: Remote MCP server over Streamable HTTP, hosted by Pickleheads. Nothing to install.
- Sign-in: OAuth. You sign in with your normal Pickleheads account and approve access on a Pickleheads screen. Your AI never sees your password.
- Permissions: Read access to what you can already see in Pickleheads. Creating and managing sessions is a separate permission you can grant or leave off.
- Who can use it: Anyone with a Pickleheads account, on every plan, including Free.
- Works with: Claude, ChatGPT, Grok, Grok Bot, Muse, Claude Code, Cursor, and most other MCP clients.
- Help and privacy: [email protected] and our Privacy Policy
Loading...
Connect it to Claude
Pickleheads is in Claude's connector directory, so there's no address to paste. It works the same on the web, desktop, and mobile apps.
1. Find Pickleheads in the directory
Open the Pickleheads listing, or in Claude open Customize, go to the Connectors tab, and search for Pickleheads.
2. Click Connect to Claude
Claude sends you to Pickleheads to sign in.
3. Sign in and allow access
Sign in with your Pickleheads account. The approval screen names the account you're connecting and lists exactly what Claude gets. Read access is always included. Creating and managing sessions is a separate permission, so leave it off if you only want answers. Click Allow, and you're done.
💡 Good to know: Claude shares the connection everywhere you use it, including Cowork and the mobile apps. Set it up once and it follows you.
Connect it to ChatGPT
Pickleheads is in ChatGPT's plugin directory, so there's no address to paste. It works the same on the web, desktop, and mobile apps.
1. Open the Pickleheads plugin
Open the Pickleheads plugin in ChatGPT, or open Plugins in ChatGPT and search for Pickleheads.
2. Click Install plugin
ChatGPT sends you to Pickleheads to sign in.
3. Sign in and allow access
Sign in with your Pickleheads account. The approval screen names the account you're connecting and lists exactly what ChatGPT gets. Read access is always included. Creating and managing sessions is a separate permission, so leave it off if you only want answers. Click Allow, and you're done.
Connect it to Grok / Grok Bot
The easiest way is to let Grok or Grok Bot set up the connection for you. Send it this message:
Help me connect Grok to Pickleheads. Here's the link to their MCP guide: https://www.pickleheads.com/guides/mcp
When it asks, sign in with your Pickleheads account and approve access.
You can also set it up yourself. Here's how:
1. Open your connectors
Grok handles this on the web, so there's no app to install. Go to grok.com/connectors.
2. Click New Connector
It's the button at the top right of the connectors page.
3. Choose Custom
Pickleheads isn't in Grok's featured list, so pick Custom at the top to add your own.
4. Name it and paste the address
Call it Pickleheads so you can spot it in the list later, and give it https://mcp.pickleheads.com/mcp as the server address.
5. Authenticate and allow access
Sign in with your Pickleheads account. The approval screen names the account you're connecting and lists exactly what Grok gets. Read access is always included. Creating and managing sessions is a separate permission, so leave it off if you only want answers. Click Allow, and you're done.
Connect it to Muse
Muse can set up the connection for you. Send it this message:
Help me connect Muse to Pickleheads. Here's the link to their MCP guide: https://www.pickleheads.com/guides/mcp
Muse will send you a sign-in link. Tap it, sign in with your Pickleheads account, and approve access. That's it.
Connect it to anything else
Cursor, VS Code, Windsurf, Claude Code, Raycast, and Instinct all want the same address: https://mcp.pickleheads.com/mcp. So does anything else built on MCP.
The setting is usually under MCP servers, custom connectors, or integrations, depending on the app. Add the address as a remote or HTTP server, sign in when it asks, and you're done. We've tested Claude and ChatGPT hardest, so those are the smoothest, but most MCP clients work.
In Claude Code, run claude mcp add --transport http pickleheads https://mcp.pickleheads.com/mcp, then type /mcp in a session to sign in.
For developers and agents: Sign-in uses OAuth 2.1 with dynamic client registration, so there's no client ID or secret to enter. The authorization server is https://clerk.pickleheads.com, and the scopes are read write offline_access.
Try these first
The connection earns its place on the questions you'd otherwise work out by hand, and the setup forms you'd otherwise click through:
- "Who's signed up for Thursday, and how many spots are left?"
- "How many people drop out at the last minute?"
- "Which members of my group haven't played since June?"
- "Who's attended the most sessions?"
- "How are my league standings looking?"
- "Who's played with us but still hasn't joined my group?"
- "Create a round robin for next Tuesday at 8pm at my usual court."
- "Move Saturday's session to 9am and cap it at 16 players."
- "Invite my Tuesday group to next week's session."
💡 Pro tip: Ask follow-ups. The answer to "who's gone quiet" is a list of names, but the useful version is the next question: "of those, who used to come every week?" Your AI still has the data from the first answer, so it can slice it again without starting over.
What it can see
Everything you can already see in the app when you're logged in, and nothing beyond that. If a player's information is hidden from you in Pickleheads, it stays hidden here.
Your groups and members
- Group details and membership
- Member activity, including who's active and who's gone quiet
- Players who've joined your sessions but aren't in your group yet
Sessions and rosters
- Session details and rosters
- Signups, including when each player signed up
- Check-ins and dropouts
Leagues, competitions, and teams
- Leagues and current standings
- Competitions and round robin results
- Teams and lineups
You and your account
- Your profile and alert settings
- Courts you follow
- Players you've partnered with
- Your invite funnel: who you invited and what happened next
- Participation and dropout reports
- Your plan usage
What it can do
If you grant the session permission when you connect, your AI can also set things up for you:
- Create a session, including round robins and weekly games, with you as the organizer
- Change a session you organize or co-host, like the time, court, player limit, or skill range
- Add players you're already connected to, or guests by name, to a session you run
- Invite one of your groups to a session
- Remove players from a session you run, whether they're on the roster, the waitlist or in requests. Your AI confirms who it's removing first.
- Remove members from a group you admin. The group owner can't be removed.
It asks before every change. Your AI tells you exactly what it's about to create or change and waits for your yes. A yes to one change isn't a yes to the next. New sessions are private unless you say otherwise, and everything follows your plan's limits, the same as in the app.
What it won't do
- Read, send, or manage chat messages
- Show anyone's email address or phone number
- Touch passwords, login details, or account deletion
- Change your subscription or see payment details
- Send scores to DUPR (it can check whether they went through)
- Delete groups, leagues, or lists
- Create or edit leagues and ladders (it'll link you to your league page instead)
- Add or invite new members to a group
Creating groups and leagues from chat is next. If there's something you'd rather do through your AI than in the app, tell us at [email protected]. What organizers ask for shapes what we build.
Privacy and data sharing
No email addresses or phone numbers, ever, for anyone. The MCP never exposes contact details to your AI, for you or for any of your players. They stay in Pickleheads.
You're handing your personal AI keys to your Pickleheads account. Make sure you trust your AI provider with information about your sessions, groups, leagues, plans, and more.
Your conversations stay with your AI. Pickleheads doesn't store the contents of your chats. We only receive the specific requests your AI makes, like "list my sessions," and we handle that data the same way we handle what you do in the app.
Disconnect any time. Remove Pickleheads from your AI tool's connector or MCP settings and the connection stops. To revoke access on our side too, email [email protected].
For everything else, read the full Pickleheads Privacy Policy.
Tools reference
For IT admins and the curious, here's every tool the connection exposes. Each one acts as you and only reaches what your account can already reach.
Your account (read)
get_my_context: your name, skill level, plan, and whether you organize or playget_my_profile: your profile, skill level, and DUPR ratingget_my_plan_usage: what you've used and have left on your planget_my_alert_settings: your notification switches (never your email or number)list_my_followed_courts,get_my_partners,get_my_invite_funnel: courts you follow, your doubles partners, and how your invites turned out
Sessions and groups (read)
list_sessions,get_session_instance: sessions you run, play in, or are invited to, with rostersget_participation_report,get_dropout_report: check-ins, no-shows, and dropouts for sessions you organizefind_players_to_add: people you can add to a session you runlist_my_groups,get_group,get_group_member_activity,list_group_prospects: your groups, their members, who's active, and who plays with you but hasn't joined
Leagues, competitions, and teams (read)
list_competitions,get_competition,get_competition_changes: round robin standings, stats, and score historylist_my_leagues,get_league,get_player_history: leagues and ladders you manage, standings, and player recordslist_my_teams,get_team: your teams, lineups, and team standingsget_dupr_submission_status: whether a session's scores reached DUPR
Courts, facilities, and help (read)
find_games_nearby,find_courts: games, open play, and courts near a placelist_integrations,get_linked_account_report: facility booking integrations and linked players, for account holderslist_skills,get_skill: how-to guides your AI uses to answer Pickleheads questions. No account data.
Sessions and groups (write, only with the session permission)
create_session: creates a session with you as the organizerupdate_session: changes a session you organize or co-hostadd_players_to_session: adds connected players or named guests to a session you runinvite_group_to_session: invites one of your groups to a sessionremove_players_from_session: removes players from the roster, waitlist, or join requests of a session you organize or co-hostremove_group_members: removes members from a group you admin
Support
Email [email protected] with anything that isn't working. Tell us which AI tool you're using and roughly when it happened, and we'll take it from there.
FAQs
