# Avoma — MCP server on mcp.ai
> Connect your Avoma account and use 16 tools for meeting assistants straight from your AI agent. Connect with your own API key. Avoma is an AI meeting assistant for recording, transcribing, analyzing, and managing meetings, calls, notes, scorecards, and conversation intelligence.

By: mcp.ai · official
Page: https://mcp.ai/avoma

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_avoma?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/avoma/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/avoma/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/avoma/skill.md
Postman collection (v2.1): https://mcp.ai/avoma/postman.json

## Tools
- avoma_create_call(end_at?: string, source: string, to_name?: string, answered?: boolean, start_at: string, direction: string, from_name?: string, to_number: string, user_email: string, external_id: string, from_number: string, is_voicemail?: boolean, participants: object[], recording_url: string, crm_associations?: object[], additional_details?: object) — Submit an externally hosted call recording to Avoma for asynchronous processing. This persistently creates external call state, and Avoma will download the recording from the supplied publicly reachab
- avoma_get_call(external_id: string) — Retrieve one externally ingested Avoma call by the dialer system's external ID.
- avoma_get_engagement_summary(is_call?: boolean, to_date: string, from_date: string, is_internal?: boolean, user_emails?: string[], is_impromptu?: boolean, meeting_type_uuids?: string[], shared_meetings_only?: boolean, meeting_outcome_uuids?: string[], recording_duration_gte?: number, recording_duration_lte?: number) — Aggregate Avoma engagement metrics across visible users for a required UTC date range and optional meeting and user filters.
- avoma_get_meeting(meeting_uuid: string, include_crm_associations?: boolean) — Retrieve one meeting by UUID, including processing/readiness state and optionally CRM associations.
- avoma_get_meeting_analysis(meeting_uuid: string) — Return Avoma's AI insights, topical and speaker segments, and sentiment records for one processed meeting in a single read-only invocation.
- avoma_get_recording(meeting_uuid: string) — Get time-limited audio and video URLs for a meeting recording.
- avoma_list_calls(to_date: string, direction?: string, from_date: string, next_cursor?: string) — List externally ingested calls in a required UTC date range, optionally filtered by inbound or outbound direction. Returns one page and a cursor.
- avoma_list_configuration_resources(order?: string, page_size?: integer, next_cursor?: string, resource_type: string) — List one Avoma configuration catalog: custom categories, smart categories, scorecards, templates, meeting types, or meeting outcomes.
- avoma_list_engagement_metrics(order?: string, is_call?: boolean, to_date: string, from_date: string, page_size?: integer, is_internal?: boolean, next_cursor?: string, user_emails?: string[], is_impromptu?: boolean, meeting_type_uuids?: string[], shared_meetings_only?: boolean, meeting_outcome_uuids?: string[], recording_duration_gte?: number, recording_duration_lte?: number) — List per-user Avoma engagement metrics over a required UTC date range with meeting and user filters. Returns one page and an opaque cursor.
- avoma_list_meetings(order?: string, is_call?: boolean, to_date: string, from_date: string, page_size?: integer, is_internal?: boolean, next_cursor?: string, crm_lead_ids?: string[], attendee_emails?: string[], crm_account_ids?: string[], crm_contact_ids?: string[], crm_opportunity_ids?: string[], recording_duration_gte?: number, include_crm_associations?: boolean) — Find meetings visible to the connected Avoma user within a required UTC date range, with optional attendee, CRM, call-type, privacy-context, duration, and ordering filters. Returns one page and an opa
- avoma_list_notes(order?: string, to_date: string, from_date: string, page_size?: integer, next_cursor?: string, meeting_uuid?: string, output_format?: string, custom_category_uuid?: string) — Retrieve Avoma notes for meetings in a required UTC date range, optionally narrowed to a meeting or custom category and rendered as JSON, HTML, or Markdown.
- avoma_list_scorecard_evaluations(to_date?: string, from_date?: string, page_size?: integer, next_cursor?: string, user_emails?: string[], meeting_uuid?: string, scorecard_uuids?: string[]) — List Avoma scorecard evaluations, optionally filtered by UTC date range, scorecard templates, meeting, or evaluated users. Returns one page at a time.
- avoma_list_snippets(to_date?: string, from_date?: string, page_size?: integer, next_cursor?: string, meeting_uuid?: string, is_ai_generated?: boolean) — Find user-created or AI-generated meeting snippets by meeting UUID or by a UTC date range of at most 180 days. Returns one page at a time.
- avoma_list_transcriptions(to_date?: string, from_date?: string, page_size?: integer, next_cursor?: string, crm_lead_ids?: string[], meeting_uuid?: string, attendee_emails?: string[], crm_account_ids?: string[], crm_contact_ids?: string[], crm_opportunity_ids?: string[]) — Find full meeting transcriptions by meeting UUID or by a UTC date range, with attendee and CRM filters. Returns one page because transcript payloads can be large.
- avoma_list_users() — Return users visible in the Avoma organization, including their UUID, email, role, teams, and active status.
- avoma_list_webhooks() — Audit the connected organization's active Avoma webhook subscriptions without reading signing secrets.

## Example prompts
- "What can I do in Avoma?"
- "Show me a summary of my Avoma account"

## Links
Docs: https://mcp.ai/docs/mcps/avoma
Website: https://mcp.ai/mcps/avoma