The Read AI MCP server is a remote MCP (Model Context Protocol) server that allows AI assistants to access Read AI's capabilities through a standardized interface. It is currently available as an open beta release.
⚠️ Before starting, make sure you have reviewed the prerequisites in Read AI API and MCP Overview.
Server Details
You'll need these details if you're setting up a custom connection to the MCP server. You don't need them if you're connecting with the ChatGPT plugin or Claude connector.
-
Server URI:
https://api.read.ai/mcp - Authentication: OAuth 2.1 (sign in using your Read AI account)
- Type: Remote MCP Server
- Transport: Streamable HTTP
If you are an EU user, you will need to set up a custom connector for Claude or a custom MCP server for ChatGPT, using these details:
-
Server URI:
https://prod-eu-api.read.ai/mcp - Authentication: OAuth 2.1 (sign in using your Read AI account)
- Type: Remote MCP Server
- Transport: Streamable HTTP
Compatible MCP Clients
The Read AI MCP server is compatible with various MCP clients, including:
- ChatGPT and Codex
- Claude (Desktop, Web, and Code)
- Microsoft Copilot Studio
- Gamma
- Other MCP-compatible clients (for example, VS Code or Cursor). In Read, the MCP card on your Integrations page (under Productivity) links to the setup documentation with View Documentation.
Available Tools
For examples of what you can do with these tools, see What can you do with Read AI's MCP server?
Once connected, the Read AI MCP server provides the following tools for finding, analyzing, organizing, and sharing your meeting data. Each tool's official name, which your AI assistant uses to call it, is listed under its heading.
Meeting tools
List meetings
Tool name: list_meetings
Browse and filter your meeting history with date-range filtering and pagination support.
What you can do:
- Browse recent meetings (up to 10 per page)
- Filter meetings by date range
- Paginate through large collections of meetings
- Includes the same detailed information as Get meeting by ID (basic metadata, summary, chapter summaries, action items, key questions, topics, transcript, metrics, and recording download) for each meeting in the list
Search meetings
Tool name: search_meeting_agent
Find meetings by what was discussed in them, rather than by when they happened. Describe what you're looking for in plain language, and a search agent finds the most relevant meetings and explains why each one matches.
To search, provide:
- Query: what you want to find, e.g. "discussions where the Q3 pricing change was decided"
Optional:
- Date range: only consider meetings that started within a specific time window
- Limit: the maximum number of meetings to return (defaults to 5, up to 10)
- Time budget: how long the search can run, from 20 to 90 seconds (defaults to 45)
What you get back:
- Each matching meeting's title, start time, and report URL
- A one-sentence explanation of why the meeting is relevant
- A supporting excerpt from the meeting transcript
Good to know:
- Search is thorough but slower than other tools, typically 20 to 60 seconds.
- Search finds meetings; it doesn't answer questions about them. Your AI assistant can use Get meeting by ID on the results to read summaries, action items, or full transcripts.
- Only meetings from roughly the last 12 months are searchable.
- Because the search is agentic, running the same query twice can return slightly different results.
Get meeting by ID
Tool name: get_meeting_by_id
Retrieve comprehensive information about a specific meeting using its meeting ID.
What you can retrieve:
- Basic metadata (title, start/end times, platform, report URL)
- Participants with attendance status
- Summary
- Chapter summaries
- Action items
- Key questions
- Topics
- Full transcript with speaker identification
- Metrics
- URL to download the meeting recording as an MP4 file
Share meeting report
Tool name: share_meeting_report
Grant another person access to a specific meeting report and, optionally, send them an email invite.
To share a report, provide:
- Meeting ID: the ID of the report you want to share
- Email address: the recipient's email. If they already have a Read AI account, access is granted directly; otherwise an email-based invite is created for them.
Optional:
-
Access level: controls what the recipient can see and do:
- Viewer (recap only): summary/recap only
- Viewer (full): full read access to the report
- Editor: read access plus the ability to edit and re-share
- Defaults to full viewer access if not specified.
- Message: a personal note included in the invite email
- Notify: whether to send an email notifying the recipient (defaults to yes; set to no to grant access silently)
Good to know:
- Only editors and owners of a meeting can share it. Viewers cannot share reports, and the action will fail if attempted.
- Ownership itself can't be transferred through this tool, only viewer or editor access.
- Re-sharing with the same person at the same access level is safe; it won't send a duplicate invite or create a duplicate grant.
Create meeting agent
Tool name: create_meeting_agent
Send a Read AI meeting agent (bot) to a video conferencing meeting on your behalf. It works with Zoom, Google Meet, and Microsoft Teams.
Zoom meetings: Read can only join a Zoom meeting if you've connected your Zoom account to Read and you're in the meeting, signed in to that same Zoom account. See Upcoming Changes to Zoom Meetings.
To deploy an agent, provide:
- Meeting URL: the full join link (e.g. a Zoom link or Google Meet URL). The platform, meeting ID, and password (if included in the link) are parsed automatically.
Or, if you'd rather specify manually:
- Platform: Zoom, Google Meet, or Microsoft Teams
- Meeting ID: the platform-specific ID (Zoom meeting number, Meet code, etc.)
- Password: only if the meeting requires one
Optional:
- Start time: schedule the agent to join at a future time. If omitted, it joins immediately.
- Title: a custom name for the meeting report. If omitted, we'll try to generate a descriptive title based on the transcript.
Good to know:
- If an agent has already been dispatched to the same meeting, requesting it again won't create a duplicate; you'll get the existing meeting record instead.
- Once the meeting is underway or complete, its data (summary, transcript, action items, etc.) becomes available via the meeting report.
- Agents can only be sent to meetings you've explicitly specified, not guessed or inferred meeting IDs.
Folder tools
List folders
Tool name: list_folders
See all of the folders you have access to, including your personal folders (called "private" by the MCP server), folders shared with you, and Smart Folders that Read AI creates for you (called "auto" folders by the MCP server).
What you can do:
- Find a folder by name
- Filter by folder type: private, shared, or auto
- Sort by your custom order, name, date created, date updated, or most recent meeting activity
- See each folder's name, color, icon, description, number of meetings, and your access level
Good to know:
- All of your folders are returned at once; there's no pagination.
- To see the meetings inside a folder, use List folder items.
Get folder
Tool name: get_folder
Retrieve the details of a specific folder using its folder ID.
What you can retrieve:
- Name, color, icon, and description
- Folder type (private, shared, or auto)
- Number of meetings in the folder
- Your access level on the folder
- For shared folders, the access level members get to meetings in the folder
- Created, updated, and last activity dates
Good to know:
- To see the meetings inside the folder, use List folder items.
List folder items
Tool name: list_folder_items
Browse the meetings in a specific folder, with pagination support.
What you can do:
- See the meetings in a folder (up to 10 per page)
- Paginate through folders with many meetings
- Includes the same detailed information as Get meeting by ID (basic metadata, summary, chapter summaries, action items, key questions, topics, transcript, metrics, and recording download) for each meeting in the list
Good to know:
- You need access to view the folder.
Create folder
Tool name: create_folder
Create a new personal (private) or shared folder to organize your meetings.
To create a folder, provide:
- Name: up to 100 characters
- Color: gray, pink, red-orange, green, yellow-green, teal, blue, or indigo
Optional:
- Icon: folder, lightning, lightbulb, star, paint, code, briefcase, building, trophy, beaker, bookmark, flag, heart, rocket, speech bubble, or trend up
- Description: up to 1,000 characters
- Folder type: private (the default) or shared
- Member access level: shared folders only. Controls whether folder members get viewer or editor access to meetings placed in the folder (defaults to viewer).
Good to know:
- You're the owner of any folder you create. To invite others to a shared folder, use Share folder.
- Each request creates a new folder, even if one with the same name already exists.
- Smart Folders (auto folders) are created by Read AI and can't be created manually.
Update folder
Tool name: update_folder
Change an existing folder's name, color, icon, or description.
To update a folder, provide:
- Folder ID: the folder you want to change
- Any of the following: name, color, icon, description, or (for shared folders) member access level
Good to know:
- Only the fields you provide are changed; everything else stays the same.
- An icon or description can be changed, but not cleared.
- You need edit access to the folder: owner for private folders, owner or editor for shared folders.
- Smart Folders (auto folders) can't be edited.
- You can't switch a folder between private and shared through the MCP server. To convert a personal folder to a shared folder, use the Read app (see Converting a personal to a shared folders).
Add meetings to folder
Tool name: add_folder_items
Add one or more meetings to an existing folder.
To add meetings, provide:
- Folder ID: the folder to add meetings to
- Meeting IDs: one or more meetings to add
Optional:
- Include recurring series: for any meeting that's part of a recurring series, also add every other meeting in that series. This is set per meeting, so you can mix recurring and one-off meetings in a single request.
Good to know:
- You need edit access to the folder: owner for private folders, owner or editor for shared folders.
- You need at least viewer access to each meeting you add, or editor access if the folder is shared.
- If you don't have enough access to any one of the meetings, the whole request fails.
- Meetings that no longer exist are skipped.
- Adding a meeting that's already in the folder has no effect.
Remove meetings from folder
Tool name: remove_folder_items
Remove one or more meetings from a folder.
To remove meetings, provide:
- Folder ID: the folder to remove meetings from
- Meeting IDs: one or more meetings to remove
Optional:
- Include recurring series: for any meeting that's part of a recurring series, also remove every other meeting in that series. This is set per meeting.
Good to know:
- Meetings are only removed from the folder; they aren't deleted.
- You need edit access to the folder. For shared folders, owning every meeting you're removing also works.
- Meetings that aren't in the folder are skipped.
Share folder
Tool name: share_folder
Give another person access to one of your shared folders and, optionally, send them an email invite.
To share a folder, provide:
- Folder ID: the shared folder you want to share
- Email address: the recipient's email
Optional:
-
Access level: controls what the recipient can do:
- Viewer: can see the folder and its meetings
- Editor: can also add and remove meetings
- Defaults to viewer if not specified.
- Message: a personal note included in the invite email
- Notify: whether to send an email notifying the recipient (defaults to yes; set to no to grant access silently)
Good to know:
- Only shared folders can be shared. You can't convert a personal (private) folder to a shared folder through the MCP server. Either convert it in the Read app (see Converting a personal to a shared folders), or create a new shared folder and add the same meetings to it.
- You need edit access to the folder (owner or editor) to share it.
- Ownership can't be transferred; only viewer or editor access can be granted.
- Sharing again with the same person at the same access level won't create a duplicate grant. However, if the recipient already has a Read AI account and notify is on, they may receive another notification email.
Delete folder
Tool name: delete_folder
Permanently delete a folder.
To delete a folder, provide:
- Folder ID: the folder you want to delete
Good to know:
- Deleting a folder can't be undone.
- Only the folder is deleted. The meetings in it aren't affected and remain fully accessible.
- Deleting a shared folder removes it for everyone it's shared with, not just you.
- Only the folder's owner can delete it.