Connect your AI assistant to Freshmint
Connect Claude, ChatGPT, Grok Bot, Cursor or another AI assistant to Freshmint, and control what it can do.
You can connect an AI assistant such as Claude, ChatGPT, Grok Bot or Cursor to Freshmint, then ask it about your events or have it do work in Freshmint for you. It signs in as you, with no API key.
Get your server address
Open Settings > Connected apps and select How to connect your AI assistant. Copy Your Freshmint server URL: https://mcp.freshmint.ai/mcp. Every assistant asks for this address.
Connect
Claude (web and desktop)
- In Claude, open Settings and go to Connectors.
- Choose Add custom connector, name it Freshmint, and paste the server URL.
- Choose Connect and sign in with Freshmint when asked.
Claude Code Run claude mcp add --transport http freshmint https://mcp.freshmint.ai/mcp in your terminal. Then type /mcp in Claude Code, choose freshmint and choose Authenticate.
ChatGPT
- Open Settings and go to Apps & Connectors. Custom connectors may need developer mode turned on.
- Add a new connector with the server URL.
- Sign in with Freshmint when asked.
Cursor, Grok Bot and other MCP clients Add a remote MCP server with the server URL. When your client asks you to log in, sign in with Freshmint.
Approve the connection
Your assistant opens Freshmint in your browser. Sign in if needed, check the app and organization named on the consent screen, and select Approve.
A connection stays active while you use it and expires after 30 days unused. Signing out of Freshmint on the web does not disconnect your assistant.
What it can do
- Look up your events, attendees, sponsors, co-hosts and contacts, including events you co-host or sponsor
- Create and update events, guest lists, tags, budgets, collection links and event settings, and turn Freshmint AI emails on or off
- Undo a batch of new events or contact changes within 24 hours
It acts as you, and can do only what your own Freshmint role already allows.
Try asking: "Show me my upcoming events and how many people have confirmed for each", or "Turn on Freshmint AI emails for my next event".
Nothing goes out without you
Anything that emails people, changes more than one record, makes something public or overwrites contact details shows a preview first. The preview lists exactly what will change and who will be emailed, and nothing happens until you say yes. Keep your assistant's own approval prompt on for Freshmint rather than allowing every action.
What it can never do
- Send custom emails or blasts to your attendees
- Remove attendees from an event
- Delete contacts
- Cancel or delete events
- Manage your team or their roles
- Touch billing or your subscription
- Delete or merge organizations
These stay in the Freshmint app.
See and revoke access
Settings > Connected apps lists every assistant you have connected and when it was last used. Select Revoke to cut one off. It loses access on its next request.
Organization admins also see their colleagues' connections, and can turn AI connections off for the whole organization. That also turns off Copilot. Turning it back on needs no reconnecting. Leaving an organization revokes your connections to it.
Common questions
Why does my assistant say AI connections are turned off? An organization admin turned them off. Ask them to switch AI connections back on in Settings > Connected apps.
Why does my assistant say the connection was revoked? It was revoked, or it expired after 30 days unused. Remove the connector and add it again. In Claude Code, type /mcp and choose Authenticate.
What if my assistant hits a limit? Freshmint caps how fast an assistant can make changes. It is told when to retry.