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.

Install the MCP server

npm install -g @itsconvo/mcp-server

Requires Node.js 18 or later.

Configure your AI assistant

Add 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.

Available Tools

Core Tools

Tool	Description	Uses AI Credits
`list_meetings`	List and search your meetings by title or date	No
`get_transcript`	Get full meeting transcript with speakers and timestamps	No
`get_summary`	Get key points, decisions, and action items	Only if generating
`get_feedback`	Get coaching feedback with communication scores	Only if generating
`ask_about_meeting`	Ask any question about a meeting	Yes
`draft_followup_email`	Generate a follow-up email from a meeting	Yes
`share_meeting`	Create a shareable link for a meeting	No
`get_upcoming_meetings`	View upcoming events from Google Calendar	No
`get_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
`prepare_for_meeting`	Search past meetings by person or company and get a consolidated briefing with open action items and past decisions	No
`weekly_digest`	Get a digest of all meetings over a time period with total time, all decisions, and all action items	No
`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 prepare_for_meeting 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 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 draft_followup_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 ask_about_meeting 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 get_account_info.

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

MCP Server