Guides

How to add Pickleheads to Claude, ChatGPT, or any other AI tool

picture of Max Ade
Max Ade

Published on: Sep 18, 2026

Connect Pickleheads to your favorite AI tool

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 that lets the AI read your data when you ask it to. 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

Connect it to Claude

1. Download the Claude desktop app

Custom connectors are set up in the desktop app, so start there if you don't have it yet. Download Claude for Mac or Windows.

2. Open Customize

It's near the bottom of the left sidebar in Claude.

The Customize option near the bottom of the Claude sidebar

3. Switch to the Connectors tab, then click Add

The tab opens on the directory of ready-made connectors. Pickleheads isn't in there, so you're adding your own.

The Connectors tab in Claude's Customize settings, with the Add menu open
The Add button on Claude's connectors directory

4. Name it and paste the address

Type Pickleheads in the first field so you can spot it in the list later, paste https://mcp.pickleheads.com/mcp in the second, then click Continue.

Claude's Add custom connector dialog filled in with the Pickleheads name and address

5. Click Connect

Pickleheads now appears in your connectors list marked Web and Custom. Sign into Pickleheads to approve access.

The Pickleheads row in Claude's connectors list, marked Web and Custom, with a Connect button

6. Confirm you started this

Claude asks whether you began the connection yourself. Click Continue connecting. It checks because a link on its own should never be able to attach anything to your account.

Claude's Finish connecting a connector confirmation screen

7. Allow access

The approval screen names the account you're connecting and lists exactly what Claude gets: read. That's the whole permission. Click Allow.

The Pickleheads approval screen showing that Claude gets read access

💡 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

1. Download the ChatGPT desktop app

MCP servers are set up in the desktop app. Download ChatGPT for Mac or Windows if you haven't already.

2. Switch to Work mode

Use the toggle at the top of the window to switch from Chat to Work. ChatGPT only supports MCP connections in Work mode, so you'll need to be in Work every time you want to use Pickleheads.

The Chat and Work toggle at the top of the ChatGPT desktop app, with Work selected

3. Open Plugins

In the desktop app, click Plugins in the left sidebar.

Plugins in the ChatGPT desktop app sidebar

4. Open the plugin settings

At the top right of the Plugins page, click the gear icon next to Add.

The gear icon next to Add on the ChatGPT Plugins page

5. Go to MCPs and add a server

Switch to the MCPs tab, then click Add server.

The MCPs tab and the Add server button in ChatGPT's plugin settings

6. Fill in the server details

Name it Pickleheads and set Type to Streamable HTTP. Paste https://mcp.pickleheads.com/mcp into the URL field. Leave the bearer token and the header fields empty, then click Save.

ChatGPT's Connect to a custom MCP form, with Streamable HTTP selected and the Pickleheads address filled in

7. Authenticate

Find Pickleheads in your server list and click Authenticate.

The Pickleheads row in ChatGPT's MCP server list with an Authenticate button

8. Sign in and allow access

Sign in with your Pickleheads account, then approve the request on the screen that follows. This is the step that actually links the two.

The Pickleheads approval screen, showing what access is being granted

9. Ask it something

Start a new chat and ask about your sessions. If ChatGPT doesn't reach for Pickleheads on its own, name it in your message.

💡 Good to know: Custom MCP connections don't sync between devices. The one you set up stays on that computer, and there's no way to add one in the ChatGPT mobile app yet. If you use ChatGPT on more than one computer, add Pickleheads on each.

Connect it to Grok

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.

The New Connector button on Grok's connectors page

3. Choose Custom

Pickleheads isn't in Grok's featured list, so pick Custom at the top to add your own.

The Custom option in Grok's New Connector panel

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, then approve the request. That's the step that actually links the two.

The Pickleheads approval screen for Grok

Connect it to anything else

Cursor, VS Code, Windsurf, Claude Code, and Raycast 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.

Try these first

The connection earns its place on the questions you'd otherwise work out by hand:

  • "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?"

💡 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

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.

Read-only, for now

It can read. It can't change anything.

It won't create a session, edit a roster, message your players, or delete anything, even if you ask it to directly. Write access is coming, and creating sessions is first in line.

If there's something you'd want to do through your AI rather than in the app, tell us. We're building the write side now, and what organizers actually ask for is shaping the order we build it in.

You're good to go. Everything about the connection, including what's shipping next, lives at pickleheads.com/mcp.

FAQs

About the author
Max Ade
Max is the co-founder and CEO of Pickleheads. As an experienced technology entrepreneur, Max turned his personal love for pickleball into a vibrant community-driven company. He actively plays and engages with the pickleball community in Atlanta, and can frequently be found at Dill Dinkers, Southside Park, and Grant Park.
Share this article

What to read next

Back to the Blog

Join the largest pickleball community in the world

...

members

Join a community of pickleball players and find new friends to play with.

...

games

Browse games and open play sessions anywhere you go.

...

locations

Find every place to play pickleball in your local area.

...

cities

Now available worldwide. Find courts & games anywhere!