Using Qflow with AI Assistants (MCP)
Qflow supports the Model Context Protocol (MCP), an open standard that allows AI assistants to interact with your Qflow account directly. You can use this to manage events, guests, and team members through natural language conversation.
What You Can Do
The following actions are available through the MCP server.
Events
createEvent - create a new event with a name, date, time zone, and optional settings
updateEvent - update an existing event's details
deleteEvent - delete an event
getEvents - list your events (10 per page, supports OData queries)
getEventStatistics - get check-in statistics for an event
Guests
createGuest - add a guest to an event
updateGuest - update a guest's details (cannot change check-in or blocked status)
deleteGuest - remove a guest from an event
getGuest - get a specific guest's details
getGuests - list guests for an event (10 per page, supports OData queries)
getGuestsByName - search guests by name
getGuestsByEmail - search guests by email address
getGuestsByBarcode - search guests by barcode (partial or exact match)
getAttendees - list guests who have checked in
getNonAttendees - list guests who have not checked in
upsertGuests - bulk import up to 200 guests at a time
Team Members
createTeamMember - create a new team member
getTeamMembers - list all team members assigned to your events
assignATeamMember - assign a team member to an event
unassignATeamMember - remove a team member from an event
Getting Started
Your AI assistant must support MCP connections. Claude Desktop and Claude Code both support MCP natively.
Add the Qflow MCP server in your AI assistant's settings.
Use the server URL https://api.qflowhub.io/qflow/mcp.
Sign in with your Qflow account when prompted.
Start asking your assistant to manage your events.
The MCP server uses the same authentication as the Qflow API. You'll be asked to sign in with your Qflow credentials the first time you connect.
Example Requests
Once connected, you can ask your AI assistant things like:
"Create an event called Summer Gala on July 15th"
"Add 50 guests from this spreadsheet to the Summer Gala"
"Show me the check-in statistics for today's event"
"Assign Sarah to the Conference event"
"Find all guests with the email domain @example.com"
"How many people haven't checked in to the Gala yet?"
Pagination and Queries
List endpoints return 10 results per page. Your AI assistant handles pagination automatically. You can also use OData query syntax to filter and sort results - your assistant will construct these queries for you based on your natural language requests.
Guest Images
When creating or updating guests with a photo, the image must meet these requirements:
Under 50KB in size
Portrait orientation - 600px x 400px
Base64 encoded
Important: You cannot change a guest's check-in or blocked status through the MCP server. These actions must be performed from the check-in app or web dashboard.