Convo API Docs

Connect AI assistants like Claude, ChatGPT, and Cursor to your Convo meeting data using the Model Context Protocol.

The Convo MCP server lets you access your meetings, transcripts, summaries, and action items directly from AI assistants like Claude, ChatGPT, and Cursor.

Meeting intelligence that helps you prepare for calls, catch up on action items, and draft follow-ups without leaving your AI assistant.

What You Can Do

Search and browse your meeting history
Read full transcripts with speaker names and timestamps
Get summaries with key points, decisions, and action items
Ask any question about a specific meeting
Draft follow-up emails that reference actual discussion points
Prepare for upcoming meetings by reviewing all past interactions with a person or company
Get a weekly digest of all meetings, decisions, and action items
Find all open action items across your meetings, filtered by owner or priority

Setup

Get your API key

API keys can only be created from the Convo desktop app, available for macOS and Windows.

Open the app, go to Settings, then API Keys, and click Create New Key. Copy the key. It starts with convo_ and is only shown once.

You need a Starter plan or above.

Configure your AI assistant

Claude on the web (claude.ai) connects through OAuth. No API key or npm install needed.

In Claude, click your workspace name, then Settings, then Connectors
Click Add custom connector
Name it Convo and use the URL https://www.itsconvo.com/api/mcp
Leave the advanced OAuth fields empty, click Add, then Connect
Sign in with your Convo account (email and password, or Google sign-in)

To try it, start a new chat and ask "What meetings did I have this week?" If Convo doesn't come up, check that the connector is turned on in the search and tools menu under the chat box.

The same connector syncs to Claude Desktop and Claude mobile automatically. Custom connectors require a paid Claude plan, and the Convo side requires a Starter plan or above.

The easiest way is the custom connector from the Claude Web tab, which syncs to Claude Desktop automatically. If you prefer a local server with your own API key, add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "convo": {
      "command": "convo-mcp",
      "env": {
        "CONVO_API_KEY": "convo_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving.

claude mcp add convo convo-mcp -e CONVO_API_KEY=convo_your_api_key_here

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "convo": {
      "command": "convo-mcp",
      "env": {
        "CONVO_API_KEY": "convo_your_api_key_here"
      }
    }
  }
}

Restart Cursor after saving.

ChatGPT connects to Convo through OAuth. No API key or npm install needed.

Open ChatGPT and go to the app/connector menu
Search for Convo and click Connect
Sign in with your Convo email and password
ChatGPT is now connected to your meetings

ChatGPT uses a hosted version of the MCP server, so there is nothing to install on your machine.

Available Tools

Core Tools

Tool	Description	Uses AI Credits
`meetings_list`	List and search your meetings by title or date	No
`meetings_get_transcript`	Get full meeting transcript with speakers and timestamps	No
`meetings_get_summary`	Get key points, decisions, and action items	Only if generating
`meetings_get_feedback`	Get coaching feedback with communication scores	Only if generating
`meetings_ask`	Ask any question about a meeting	Yes
`meetings_draft_email`	Generate a follow-up email from a meeting	Yes
`meetings_share`	Create a shareable link for a meeting	No
`calendar_upcoming`	View upcoming events from Google Calendar	No
`account_info`	Check your subscription tier and API usage	No

Cross-Meeting Intelligence

These tools work across multiple meetings, pulling data from your recent history.

Tool	Description	Uses AI Credits
`intelligence_prepare`	Search past meetings by person or company and get a consolidated briefing with open action items and past decisions	No
`intelligence_weekly_digest`	Get a digest of all meetings over a time period with total time, all decisions, and all action items	No
`intelligence_find_action_items`	Find all action items across recent meetings, filterable by owner	No

Built-in Prompts

These are pre-built workflows that appear as prompt templates in your AI assistant.

Prompt	Description
`meeting-prep`	Prepare for an upcoming meeting by reviewing past interactions
`weekly-review`	Get a consolidated review of your week
`follow-up-blitz`	Draft follow-up emails for all recent meetings at once

Example Conversations

Preparing for a meeting:

"I have a call with Sarah from Acme Corp tomorrow. What should I know?"

The AI will use intelligence_prepare to search your past meetings, pull all summaries and action items, and give you a briefing with suggested talking points.

Catching up on action items:

"What action items am I behind on from the last two weeks?"

The AI will use intelligence_find_action_items to scan all recent meetings and return a prioritized list with owners and source meetings.

Drafting follow-ups:

"Draft follow-up emails for all my calls from the last 3 days"

The AI will list recent meetings, get their summaries, and use meetings_draft_email for each one.

Asking about a specific meeting:

"What did we decide about pricing in the Q1 review?"

The AI will search for the meeting, then use meetings_ask to answer based on the transcript.

Troubleshooting

"CONVO_API_KEY environment variable is required" The API key is not set. Check your MCP configuration and make sure the CONVO_API_KEY value is correct.

"Invalid API key" The key is wrong or has been revoked. Create a new key in Settings within the Convo app.

"API error 429" You've hit the rate limit. Wait a few minutes and try again. Check your limits with account_info.

"API error 403" Your subscription tier doesn't support API access. You need a Starter plan or above.

Claude connector shows as disconnected right after signing in The OAuth sign-in worked, but your Convo account is on the Free plan. The hosted MCP server requires a Starter plan or above.

Claude's sign-in page never appeared Your browser blocked the popup. Allow popups for claude.ai and click Connect again.

MCP Server