Claap MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'claapmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Claap MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'claapmcp_list_workspaces',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "claapmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Claap MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="claapmcp_list_workspaces",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update recording view, recording field, deal view — Update an existing recording view (saved preset of meetings)
• List views, users, recording fields — List the views (saved presets) of a Claap workspace across recordings (meetings), deals, companies and contacts, grouped by entity
• Get user, recording, deal view — Get a single user of a Claap workspace by userId or email, with its id, name, email, state, license and role
• Create recording view, recording field, deal view — Create a recording view (saved preset) in a Claap workspace
• Search recording transcripts, emails, deals — Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

claapmcp_create_admin_automation#Create an admin automation in a Claap workspace. An admin automation applies actions (autoRecord, autoShare, moveToFolder i.e. auto-add to a folder, updateOverview i.e. auto-personalize the summary with the given sectionIds) to the meetings matching its filters. Filter types: MeetingType (Internal/External), OrganizerIs (meeting host), ParticipantsContains (people), RecorderUserGroupIs (team), TextContains/TextIs/TextExists (title), MeetingSourceIs, FolderIs (folder/channel). Filters are combined with the combineWith operator (Or by default) and each filter can be negated with not. By default new admin automations get the highest priority; set beforeAdminAutomationId to insert the automation right before another one instead. By default admin automations are enforced (disallowUserOverride: true), meaning members cannot override them. When name is omitted it is generated from the actions and filters. When authenticating as a user, only workspace admins can create admin automations. The autoRecord action cannot be combined with a FolderIs filter.7 params▾

Create an admin automation in a Claap workspace. An admin automation applies actions (autoRecord, autoShare, moveToFolder i.e. auto-add to a folder, updateOverview i.e. auto-personalize the summary with the given sectionIds) to the meetings matching its filters. Filter types: MeetingType (Internal/External), OrganizerIs (meeting host), ParticipantsContains (people), RecorderUserGroupIs (team), TextContains/TextIs/TextExists (title), MeetingSourceIs, FolderIs (folder/channel). Filters are combined with the combineWith operator (Or by default) and each filter can be negated with not. By default new admin automations get the highest priority; set beforeAdminAutomationId to insert the automation right before another one instead. By default admin automations are enforced (disallowUserOverride: true), meaning members cannot override them. When name is omitted it is generated from the actions and filters. When authenticating as a user, only workspace admins can create admin automations. The autoRecord action cannot be combined with a FolderIs filter.

NameTypeRequiredDescription

actionsobjectrequiredNo description.

workspaceIdstringrequiredNo description.

beforeAdminAutomationIdstringoptionalNo description.

combineWithstringoptionalNo description.

disallowUserOverridebooleanoptionalNo description.

filtersarrayoptionalNo description.

namestringoptionalNo description.

claapmcp_create_company_field#Create an AI field for companies in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against the activity of each company. The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_company_views and accepted by create_company_view and update_company_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing companies. Select and MultiSelect output types require coloredSelectOptions. Check list_company_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.4 params▾

Create an AI field for companies in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against the activity of each company. The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_company_views and accepted by create_company_view and update_company_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing companies. Select and MultiSelect output types require coloredSelectOptions. Check list_company_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.

NameTypeRequiredDescription

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

creatorEmailstringoptionalNo description.

claapmcp_create_company_view#Create a company view (saved preset) in a Claap workspace, with filters, sorting and columns. Discover valid column, filter and sort identifiers via search_companies and list_company_views. When authenticating with an API key, creatorEmail is required and sets the view owner.9 params▾

Create a company view (saved preset) in a Claap workspace, with filters, sorting and columns. Discover valid column, filter and sort identifiers via search_companies and list_company_views. When authenticating with an API key, creatorEmail is required and sets the view owner.

NameTypeRequiredDescription

namestringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

creatorEmailstringoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

sortarrayoptionalNo description.

visibilitystringoptionalNo description.

claapmcp_create_contact#Create a contact in a Claap workspace with the same fields as the manual creation flow of the app: a name and an email address. If a contact already exists for this email, its name is updated instead. When authenticating with an API key, creatorEmail is required and sets the contact author.4 params▾

Create a contact in a Claap workspace with the same fields as the manual creation flow of the app: a name and an email address. If a contact already exists for this email, its name is updated instead. When authenticating with an API key, creatorEmail is required and sets the contact author.

NameTypeRequiredDescription

emailstringrequiredContact email address.

namestringrequiredContact name.

workspaceIdstringrequiredNo description.

creatorEmailstringoptionalEmail of the workspace member recorded as the author of this manual change.

claapmcp_create_contact_view#Create a contact view (saved preset) in a Claap workspace, with filters, sorting and columns. Discover valid column, filter and sort identifiers via search_contacts and list_contact_views. When authenticating with an API key, creatorEmail is required and sets the view owner.9 params▾

Create a contact view (saved preset) in a Claap workspace, with filters, sorting and columns. Discover valid column, filter and sort identifiers via search_contacts and list_contact_views. When authenticating with an API key, creatorEmail is required and sets the view owner.

NameTypeRequiredDescription

namestringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

creatorEmailstringoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

sortarrayoptionalNo description.

visibilitystringoptionalNo description.

claapmcp_create_deal_field#Create an AI field for deals in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against all the activity of each deal (recordings and emails). The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_deal_views and accepted by create_deal_view and update_deal_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing deals. Select and MultiSelect output types require coloredSelectOptions. crmField maps the field to a CRM property and is validated against the connected CRM. Check list_deal_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.5 params▾

Create an AI field for deals in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against all the activity of each deal (recordings and emails). The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_deal_views and accepted by create_deal_view and update_deal_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing deals. Select and MultiSelect output types require coloredSelectOptions. crmField maps the field to a CRM property and is validated against the connected CRM. Check list_deal_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.

NameTypeRequiredDescription

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

creatorEmailstringoptionalNo description.

crmFieldobjectoptionalNo description.

claapmcp_create_deal_view#Create a deal view (saved preset) in a Claap workspace, with filters, sorting and columns (including AI-generated insight columns). Discover valid column, filter and sort identifiers via search_deals and list_deal_views. When authenticating with an API key, creatorEmail is required and sets the view owner.9 params▾

Create a deal view (saved preset) in a Claap workspace, with filters, sorting and columns (including AI-generated insight columns). Discover valid column, filter and sort identifiers via search_deals and list_deal_views. When authenticating with an API key, creatorEmail is required and sets the view owner.

NameTypeRequiredDescription

namestringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

creatorEmailstringoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

sortarrayoptionalNo description.

visibilitystringoptionalNo description.

claapmcp_create_recording_field#Create an AI field for meeting recordings in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against each recording transcript. The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_recording_views and accepted by create_recording_view and update_recording_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing recordings. Select and MultiSelect output types require coloredSelectOptions. crmField maps the field to a CRM property and is validated against the connected CRM. Check list_recording_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.5 params▾

Create an AI field for meeting recordings in a Claap workspace. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against each recording transcript. The created field joins the workspace AI field library and can be used as a view column: its fieldId matches the AiSection column fieldIds returned by list_recording_views and accepted by create_recording_view and update_recording_view. The field is not visible in the app until it is added to a view. Creating a field does not generate values for existing recordings. Select and MultiSelect output types require coloredSelectOptions. crmField maps the field to a CRM property and is validated against the connected CRM. Check list_recording_fields first to avoid creating a duplicate of an existing field. When authenticating with an API key, creatorEmail is required and sets the field author.

NameTypeRequiredDescription

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

creatorEmailstringoptionalNo description.

crmFieldobjectoptionalOptional mapping to a CRM property, validated against the connected CRM.

claapmcp_create_recording_view#Create a recording view (saved preset) in a Claap workspace. A view is a curated set of recordings (meetings) with filters, sorting and columns (including AI-generated insight columns). Discover valid column identifiers, including AI insight fieldIds, via list_recording_views. Valid filter and sort fields are defined in the input schema of this tool. When authenticating with an API key, creatorEmail is required and sets the view owner.8 params▾

Create a recording view (saved preset) in a Claap workspace. A view is a curated set of recordings (meetings) with filters, sorting and columns (including AI-generated insight columns). Discover valid column identifiers, including AI insight fieldIds, via list_recording_views. Valid filter and sort fields are defined in the input schema of this tool. When authenticating with an API key, creatorEmail is required and sets the view owner.

NameTypeRequiredDescription

namestringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

creatorEmailstringoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

sortarrayoptionalNo description.

claapmcp_get_company#Get a single company of a Claap workspace with its full CRM fields, domains, related contactIds and dealIds. Discover the companyId via list_companies or search_companies.2 params▾

Get a single company of a Claap workspace with its full CRM fields, domains, related contactIds and dealIds. Discover the companyId via list_companies or search_companies.

NameTypeRequiredDescription

companyIdstringrequiredDiscover the companyId via list_companies or search_companies.

workspaceIdstringrequiredNo description.

claapmcp_get_company_view#Fetch the rows of a Claap company view: each row is a company matching the view filters, with a value for each of the view columns. Discover available views via list_company_views. To fetch only the rows without column values, prefer list_companies with viewId.4 params▾

Fetch the rows of a Claap company view: each row is a company matching the view filters, with a value for each of the view columns. Discover available views via list_company_views. To fetch only the rows without column values, prefer list_companies with viewId.

NameTypeRequiredDescription

viewIdstringrequiredThe ID of the company view to fetch rows for. Use list_company_views to discover IDs.

workspaceIdstringrequiredNo description.

cursorstringoptionalOpaque cursor returned as `nextCursor` by a previous call. Pass the value VERBATIM to fetch the next page of results. Omit on the first call.

limitnumberoptionalMaximum number of results per page (default 10, max 100). ALWAYS paginate via `nextCursor`.

claapmcp_get_contact#Get a single contact of a Claap workspace with its full CRM fields and its AI-generated summary when one has been generated. Discover the contactId via list_contacts or search_contacts.2 params▾

Get a single contact of a Claap workspace with its full CRM fields and its AI-generated summary when one has been generated. Discover the contactId via list_contacts or search_contacts.

NameTypeRequiredDescription

contactIdstringrequiredDiscover the contactId via list_contacts or search_contacts.

workspaceIdstringrequiredNo description.

claapmcp_get_contact_view#Fetch the rows of a Claap contact view: each row is a contact matching the view filters, with a value for each of the view columns. Discover available views via list_contact_views. To fetch only the rows without column values, prefer list_contacts with viewId.4 params▾

Fetch the rows of a Claap contact view: each row is a contact matching the view filters, with a value for each of the view columns. Discover available views via list_contact_views. To fetch only the rows without column values, prefer list_contacts with viewId.

NameTypeRequiredDescription

viewIdstringrequiredThe ID of the contact view to fetch rows for. Use list_contact_views to discover IDs.

workspaceIdstringrequiredNo description.

cursorstringoptionalOpaque cursor returned as `nextCursor` by a previous call. Pass the value VERBATIM (do not construct, modify, decode, or invent a cursor) to fetch the next page of results. Omit on the first call.

limitnumberoptionalMaximum number of results per page (default 10, max 100). The response includes `total` and, when more results exist, `nextCursor`. ALWAYS paginate via `nextCursor`.

claapmcp_get_deal#Get a single deal of a Claap workspace with its full CRM fields. Discover the dealId via list_deals or search_deals. When returnAiFields is true, the response includes the value of each AI field of the workspace deal library for this deal (answer and state); fields without a generated value have state Missing.3 params▾

Get a single deal of a Claap workspace with its full CRM fields. Discover the dealId via list_deals or search_deals. When returnAiFields is true, the response includes the value of each AI field of the workspace deal library for this deal (answer and state); fields without a generated value have state Missing.

NameTypeRequiredDescription

dealIdstringrequiredDiscover the dealId via list_deals or search_deals.

workspaceIdstringrequiredNo description.

returnAiFieldsbooleanoptionalInclude the AI field values of the deal in aiFields.

claapmcp_get_deal_view#Fetch the rows of a Claap deal view: each row is a deal matching the view filters, with a value for each of the view columns, including AI-generated insight columns. Discover available views via list_deal_views. To fetch only the rows without column values, prefer list_deals with viewId.4 params▾

Fetch the rows of a Claap deal view: each row is a deal matching the view filters, with a value for each of the view columns, including AI-generated insight columns. Discover available views via list_deal_views. To fetch only the rows without column values, prefer list_deals with viewId.

NameTypeRequiredDescription

viewIdstringrequiredThe ID of the deal view to fetch rows for. Use list_deal_views to discover IDs.

workspaceIdstringrequiredNo description.

cursorstringoptionalOpaque cursor returned as `nextCursor` by a previous call. Pass the value VERBATIM to fetch the next page of results. Omit on the first call.

limitnumberoptionalMaximum number of results per page (default 10, max 100). ALWAYS paginate via `nextCursor`.

claapmcp_get_email#Fetch the full email content including the body for a given message ID from the workspace.2 params▾

Fetch the full email content including the body for a given message ID from the workspace.

NameTypeRequiredDescription

messageIdstringrequiredThe email message ID to fetch.

workspaceIdstringrequiredThe Claap workspace ID the email belongs to.

claapmcp_get_recording#Get ONE recording (captured meeting or call) of a Claap workspace by recordingId, with its full metadata and its AI-generated summary. The summary is the cheap way to know what a meeting was about — prefer it over get_recording_transcript, which returns the entire transcript. Note the singular name: this tool takes exactly one recordingId and returns one recording. To search or filter across many recordings, use get_recordings (plural) instead. Discover the recordingId via get_recordings or search_recording_transcripts.2 params▾

Get ONE recording (captured meeting or call) of a Claap workspace by recordingId, with its full metadata and its AI-generated summary. The summary is the cheap way to know what a meeting was about — prefer it over get_recording_transcript, which returns the entire transcript. Note the singular name: this tool takes exactly one recordingId and returns one recording. To search or filter across many recordings, use get_recordings (plural) instead. Discover the recordingId via get_recordings or search_recording_transcripts.

NameTypeRequiredDescription

recordingIdstringrequiredDiscover the recordingId via get_recordings or search_recording_transcripts.

workspaceIdstringrequiredNo description.

claapmcp_get_recording_transcript#Fetch the full transcript for a given recording.2 params▾

Fetch the full transcript for a given recording.

NameTypeRequiredDescription

recordingIdstringrequiredThe ID of the recording to get the transcript for.

workspaceIdstringrequiredThe Claap workspace ID the recording belongs to.

claapmcp_get_recording_view#Fetch the rows of a Claap recording view: each row is a recording matching the view filters, with AI-generated insight values for each of the view columns. Workspaces define their own views (common examples: MEDDIC/SPICED qualification, hiring rubrics, objection trackers). Discover available views via list_recording_views.4 params▾

Fetch the rows of a Claap recording view: each row is a recording matching the view filters, with AI-generated insight values for each of the view columns. Workspaces define their own views (common examples: MEDDIC/SPICED qualification, hiring rubrics, objection trackers). Discover available views via list_recording_views.

NameTypeRequiredDescription

viewIdstringrequiredThe ID of the recording view to fetch rows for.

workspaceIdstringrequiredThe Claap workspace ID the view belongs to.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

claapmcp_get_recordings#Query the recording metadata database with a set of filters. Returns a collection of recording metadata ordered by relevance and creation date descending.5 params▾

Query the recording metadata database with a set of filters. Returns a collection of recording metadata ordered by relevance and creation date descending.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to query recordings from.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

filtersobjectoptionalFilters to apply to the recording query.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortarrayoptionalSort dimensions. When omitted, results are ordered by relevance and creation date descending.

claapmcp_get_user#Get a single user of a Claap workspace by userId or email, with its id, name, email, state, license and role.3 params▾

Get a single user of a Claap workspace by userId or email, with its id, name, email, state, license and role.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

emailstringoptionalEmail of the user to fetch.

userIdstringoptionalDiscover the userId via list_users.

claapmcp_list_admin_automations#List the admin automations of a Claap workspace, in priority order (the first admin automation has the highest priority). Admin automations automatically apply actions (autoRecord, autoShare, moveToFolder i.e. auto-add to a folder, updateOverview i.e. auto-personalize the summary) to the meetings matching their filters.1 param▾

List the admin automations of a Claap workspace, in priority order (the first admin automation has the highest priority). Admin automations automatically apply actions (autoRecord, autoShare, moveToFolder i.e. auto-add to a folder, updateOverview i.e. auto-personalize the summary) to the meetings matching their filters.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_companies#List the companies of a Claap workspace, sorted by creation date descending and paginated with a cursor. Pass viewId to return the companies of a saved view, applying its filters and sorting. Use search_companies instead for other filtered or sorted queries, and get_company to read a single company.4 params▾

List the companies of a Claap workspace, sorted by creation date descending and paginated with a cursor. Pass viewId to return the companies of a saved view, applying its filters and sorting. Use search_companies instead for other filtered or sorted queries, and get_company to read a single company.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

cursorstringoptionalPaginate the results starting at the cursor returned by a previous call.

limitnumberoptionalReturn at most "limit" results. Default 20.

viewIdstringoptionalReturn only the companies of this view: its filters and sorting apply. Use list_company_views to discover view IDs.

claapmcp_list_company_fields#List the AI field library of a Claap workspace for companies. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against the activity of each company. Returns the full definition of each field, including the fieldId accepted by update_company_field and by the AiSection columns of create_company_view and update_company_view. Archived fields are excluded unless includeArchived is true.2 params▾

List the AI field library of a Claap workspace for companies. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against the activity of each company. Returns the full definition of each field, including the fieldId accepted by update_company_field and by the AiSection columns of create_company_view and update_company_view. Archived fields are excluded unless includeArchived is true.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

includeArchivedbooleanoptionalInclude archived AI fields in the results. Defaults to false.

claapmcp_list_company_views#List the company views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_company_view and update_company_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.1 param▾

List the company views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_company_view and update_company_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_contact_views#List the contact views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_contact_view and update_contact_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.1 param▾

List the contact views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_contact_view and update_contact_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_contacts#List the contacts of a Claap workspace, sorted by name ascending and paginated with a cursor. Pass viewId to return the contacts of a saved view, applying its filters and sorting. Use search_contacts instead for other filtered or sorted queries, and get_contact to read a single contact. Contacts bound to a workspace user (userId set, isExternal false) are included but cannot be modified with update_contact.4 params▾

List the contacts of a Claap workspace, sorted by name ascending and paginated with a cursor. Pass viewId to return the contacts of a saved view, applying its filters and sorting. Use search_contacts instead for other filtered or sorted queries, and get_contact to read a single contact. Contacts bound to a workspace user (userId set, isExternal false) are included but cannot be modified with update_contact.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

cursorstringoptionalPaginate the results starting at the cursor returned by a previous call.

limitnumberoptionalReturn at most "limit" results. Default 20.

viewIdstringoptionalReturn only the contacts of this view: its filters and sorting apply. Use list_contact_views to discover view IDs.

claapmcp_list_deal_fields#List the AI field library of a Claap workspace for deals. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against all the activity of each deal (recordings and emails). Returns the full definition of each field, including the fieldId accepted by update_deal_field and by the AiSection columns of create_deal_view and update_deal_view. Archived fields are excluded unless includeArchived is true.2 params▾

List the AI field library of a Claap workspace for deals. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against all the activity of each deal (recordings and emails). Returns the full definition of each field, including the fieldId accepted by update_deal_field and by the AiSection columns of create_deal_view and update_deal_view. Archived fields are excluded unless includeArchived is true.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

includeArchivedbooleanoptionalInclude archived AI fields in the results. Defaults to false.

claapmcp_list_deal_owners#List the deal owners of the CRM connected to a Claap workspace (only Hubspot is supported), with their name and email. Use it to discover the valid ownerId values accepted by update_deal, or to find the ownerId of a known email with the email filter.2 params▾

List the deal owners of the CRM connected to a Claap workspace (only Hubspot is supported), with their name and email. Use it to discover the valid ownerId values accepted by update_deal, or to find the ownerId of a known email with the email filter.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

emailstringoptionalReturn only the owners with this email (exact match).

claapmcp_list_deal_stages#List the deal stages of the CRM connected to a Claap workspace (only Hubspot is supported), with the pipeline each stage belongs to. Use it to discover the valid stageId values accepted by update_deal.1 param▾

List the deal stages of the CRM connected to a Claap workspace (only Hubspot is supported), with the pipeline each stage belongs to. Use it to discover the valid stageId values accepted by update_deal.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_deal_types#List the deal types of the CRM connected to a Claap workspace (only Hubspot is supported). Use it to discover the valid typeId values accepted by update_deal.1 param▾

List the deal types of the CRM connected to a Claap workspace (only Hubspot is supported). Use it to discover the valid typeId values accepted by update_deal.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_deal_views#List the deal views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_deal_view and update_deal_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.1 param▾

List the deal views (saved presets) of a Claap workspace, with their viewId, filters, sorting and columns. Use it to find the viewId expected by get_deal_view and update_deal_view. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

claapmcp_list_deals#List the deals of a Claap workspace with their full CRM fields, sorted by opened date descending and paginated with a cursor. Pass viewId to return the deals of a saved view, applying its filters and sorting. Use search_deals instead for other filtered or sorted queries, and get_deal to read a single deal.4 params▾

List the deals of a Claap workspace with their full CRM fields, sorted by opened date descending and paginated with a cursor. Pass viewId to return the deals of a saved view, applying its filters and sorting. Use search_deals instead for other filtered or sorted queries, and get_deal to read a single deal.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

cursorstringoptionalPaginate the results starting at the cursor returned by a previous call.

limitnumberoptionalReturn at most "limit" results. Default 20.

viewIdstringoptionalReturn only the deals of this view: its filters and sorting apply. Use list_deal_views to discover view IDs.

claapmcp_list_emails#List emails across the workspace with metadata (sender, recipients, subject, sent date). Supports filtering by contact, company, deal, or thread. Results are sorted by sent date.9 params▾

List emails across the workspace with metadata (sender, recipients, subject, sent date). Supports filtering by contact, company, deal, or thread. Results are sorted by sent date.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to list emails from.

companyIdstringoptionalFilter by company ID.

contactIdstringoptionalFilter by contact ID (sender or recipient).

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

dealIdstringoptionalFilter by deal ID.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortBystringoptionalSort field. Defaults to sentAt.

sortOrderstringoptionalSort order. Defaults to desc (most recent first).

threadIdstringoptionalFilter by email thread ID.

claapmcp_list_recording_fields#List the AI field library of a Claap workspace for meeting recordings. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against each recording transcript. Returns the full definition of each field, including the fieldId accepted by update_recording_field and by the AiSection columns of create_recording_view and update_recording_view. Archived fields are excluded unless includeArchived is true. One-off view sections that were never promoted to the library are not included; discover those via the AiSection columns of list_recording_views.2 params▾

List the AI field library of a Claap workspace for meeting recordings. An AI field is a custom prompt with a typed output (paragraph, list, select, rating...) evaluated by AI against each recording transcript. Returns the full definition of each field, including the fieldId accepted by update_recording_field and by the AiSection columns of create_recording_view and update_recording_view. Archived fields are excluded unless includeArchived is true. One-off view sections that were never promoted to the library are not included; discover those via the AiSection columns of list_recording_views.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

includeArchivedbooleanoptionalInclude archived AI fields in the results. Defaults to false.

claapmcp_list_recording_views#List the recording views configured in a Claap workspace. A view is a curated set of recordings enriched with AI-generated insight columns. Common examples include sales qualification frameworks (MEDDIC, SPICED, BANT), hiring rubrics, and objection trackers. Prefer views over get_recordings when a view matches the user question. Use get_recording_view to read a specific view's rows.1 param▾

List the recording views configured in a Claap workspace. A view is a curated set of recordings enriched with AI-generated insight columns. Common examples include sales qualification frameworks (MEDDIC, SPICED, BANT), hiring rubrics, and objection trackers. Prefer views over get_recordings when a view matches the user question. Use get_recording_view to read a specific view's rows.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to list recording views from.

claapmcp_list_users#List the users of a Claap workspace with their id, name, email, state, license and role, paginated with a cursor. Use this to resolve user ids for user-based filters. Use search_contacts instead to search external contacts.3 params▾

List the users of a Claap workspace with their id, name, email, state, license and role, paginated with a cursor. Use this to resolve user ids for user-based filters. Use search_contacts instead to search external contacts.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

cursorstringoptionalPaginate the results starting at the cursor returned by a previous call. Pages may contain fewer than "limit" results; iterate until no nextCursor is returned.

limitnumberoptionalReturn at most "limit" results. Default 20.

claapmcp_list_views#List the views (saved presets) of a Claap workspace across recordings (meetings), deals, companies and contacts, grouped by entity. Restrict the output with the entities parameter: the entities set to false are returned as empty arrays; when omitted, all entities are listed. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.2 params▾

List the views (saved presets) of a Claap workspace across recordings (meetings), deals, companies and contacts, grouped by entity. Restrict the output with the entities parameter: the entities set to false are returned as empty arrays; when omitted, all entities are listed. Built-in default views are included and flagged with isDefault: true; they cannot be updated or deleted.

NameTypeRequiredDescription

workspaceIdstringrequiredNo description.

entitiesobjectoptionalNo description.

claapmcp_list_workspaces#List all Claap workspaces the user has access to.0 params▾

List all Claap workspaces the user has access to.

claapmcp_search_companies#Search the Claap company database.5 params▾

Search the Claap company database.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

namestringoptionalComplete or partial name or domain of the company to search for.

sortarrayoptionalSort dimensions to apply to the search results.

claapmcp_search_contacts#Search the Claap contact database. Returns both workspace users and external contacts.5 params▾

Search the Claap contact database. Returns both workspace users and external contacts.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

querystringoptionalComplete or partial name, email or domain of the contact to search for.

sortarrayoptionalSort dimensions to apply to the search results. When omitted, results are ordered by relevance.

claapmcp_search_deals#Search the Claap deal database with filters and sorting options.5 params▾

Search the Claap deal database with filters and sorting options.

NameTypeRequiredDescription

filtersobjectrequiredFilters to apply to the search.

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortarrayoptionalSort dimensions to apply to the search results.

claapmcp_search_emails#Search email content using semantic or keyword search across the workspace. Returns results as chunks with text snippets and metadata. Multiple results can be related to the same email (different chunks from the same message). Supports filtering by contact, company, or deal.7 params▾

Search email content using semantic or keyword search across the workspace. Returns results as chunks with text snippets and metadata. Multiple results can be related to the same email (different chunks from the same message). Supports filtering by contact, company, or deal.

NameTypeRequiredDescription

searchobjectrequiredSearch query and technique.

workspaceIdstringrequiredThe Claap workspace ID to search within.

companyIdstringoptionalFilter by company ID.

contactIdstringoptionalFilter by contact ID (sender or recipient).

cursorstringoptionalOpaque cursor for keyword search pagination. Not supported for semantic search.

dealIdstringoptionalFilter by deal ID.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

claapmcp_search_recording_transcripts#Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata. Returns a collection of transcript chunks grouped by recording.5 params▾

Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata. Returns a collection of transcript chunks grouped by recording.

NameTypeRequiredDescription

searchobjectrequiredSearch query and technique.

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor for keyword search pagination. Not supported for semantic search.

filtersobjectoptionalFilters to apply to the search.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

claapmcp_update_admin_automation#Update an existing admin automation of a Claap workspace. This is a full replace: the admin automation becomes exactly what is sent, so always provide the complete desired actions, filters, combineWith and disallowUserOverride values (unlike update_recording_view, omitted fields are not preserved). Set beforeAdminAutomationId to move the automation right before another one; when omitted the priority is unchanged. Discover the adminAutomationId with list_admin_automations. When authenticating as a user, only workspace admins can update admin automations.8 params▾

Update an existing admin automation of a Claap workspace. This is a full replace: the admin automation becomes exactly what is sent, so always provide the complete desired actions, filters, combineWith and disallowUserOverride values (unlike update_recording_view, omitted fields are not preserved). Set beforeAdminAutomationId to move the automation right before another one; when omitted the priority is unchanged. Discover the adminAutomationId with list_admin_automations. When authenticating as a user, only workspace admins can update admin automations.

NameTypeRequiredDescription

actionsobjectrequiredNo description.

adminAutomationIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

beforeAdminAutomationIdstringoptionalNo description.

combineWithstringoptionalNo description.

disallowUserOverridebooleanoptionalNo description.

filtersarrayoptionalNo description.

namestringoptionalNo description.

claapmcp_update_company_field#Update an AI field for companies. This is a full replace: always send the complete desired definition (title and prompt). Discover fieldIds and current definitions via list_company_fields. The field is not visible in the app until it is added to a view.4 params▾

Update an AI field for companies. This is a full replace: always send the complete desired definition (title and prompt). Discover fieldIds and current definitions via list_company_fields. The field is not visible in the app until it is added to a view.

NameTypeRequiredDescription

fieldIdstringrequiredNo description.

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

claapmcp_update_company_view#Update an existing company view (saved preset). Only the provided top-level fields are changed; omitted ones are left as-is. Beware that filters is replaced as a whole: any filter missing from a provided filters object is cleared, including insights, which may have been set from the app. Send the filters returned by get_company_view with your changes applied. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_company_views.8 params▾

Update an existing company view (saved preset). Only the provided top-level fields are changed; omitted ones are left as-is. Beware that filters is replaced as a whole: any filter missing from a provided filters object is cleared, including insights, which may have been set from the app. Send the filters returned by get_company_view with your changes applied. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_company_views.

NameTypeRequiredDescription

viewIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

namestringoptionalNo description.

sortarrayoptionalNo description.

claapmcp_update_contact#Update the name and/or email address of an existing contact of a Claap workspace. Only the provided fields are changed; omitted fields are left as-is. Contacts bound to a workspace user cannot be edited, and the email of a contact linked to a CRM entity must be changed in the CRM instead. Discover the contactId via list_contacts or search_contacts. When authenticating with an API key, creatorEmail is required and sets the author of the change.5 params▾

Update the name and/or email address of an existing contact of a Claap workspace. Only the provided fields are changed; omitted fields are left as-is. Contacts bound to a workspace user cannot be edited, and the email of a contact linked to a CRM entity must be changed in the CRM instead. Discover the contactId via list_contacts or search_contacts. When authenticating with an API key, creatorEmail is required and sets the author of the change.

NameTypeRequiredDescription

contactIdstringrequiredDiscover the contactId via list_contacts or search_contacts.

workspaceIdstringrequiredNo description.

creatorEmailstringoptionalEmail of the workspace member recorded as the author of this manual change.

emailstringoptionalNew contact email address.

namestringoptionalNew contact name.

claapmcp_update_contact_view#Update an existing contact view (saved preset). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_contact_views.8 params▾

Update an existing contact view (saved preset). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_contact_views.

NameTypeRequiredDescription

viewIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

namestringoptionalNo description.

sortarrayoptionalNo description.

claapmcp_update_deal#Update an existing deal of a Claap workspace. The update is written to the connected CRM (only Hubspot is supported) then mirrored on the Claap deal. Only the provided fields are changed; omitted fields are left as-is. Discover the dealId via list_deals or search_deals, and the valid stageId, typeId and ownerId values via list_deal_stages, list_deal_types and list_deal_owners.8 params▾

Update an existing deal of a Claap workspace. The update is written to the connected CRM (only Hubspot is supported) then mirrored on the Claap deal. Only the provided fields are changed; omitted fields are left as-is. Discover the dealId via list_deals or search_deals, and the valid stageId, typeId and ownerId values via list_deal_stages, list_deal_types and list_deal_owners.

NameTypeRequiredDescription

dealIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

amountnumberoptionalDeal amount, in the currency configured in the CRM.

closedAtstringoptionalDeal close date (ISO datetime).

ownerIdstringoptionalDeal owner id in the CRM (ownerCrmId). List the valid ids with the list_deal_owners tool.

stageIdstringoptionalStage id in the CRM (stageCrmId). List the valid ids with the list_deal_stages tool.

titlestringoptionalDeal title.

typeIdstringoptionalDeal type id in the CRM (dealTypeCrmId). List the valid ids with the list_deal_types tool.

claapmcp_update_deal_field#Update an AI field for deals. This is a full replace: always send the complete desired definition (title, prompt, and the optional crmField); omitted optional fields are cleared. Discover fieldIds and current definitions via list_deal_fields. The field is not visible in the app until it is added to a view.5 params▾

Update an AI field for deals. This is a full replace: always send the complete desired definition (title, prompt, and the optional crmField); omitted optional fields are cleared. Discover fieldIds and current definitions via list_deal_fields. The field is not visible in the app until it is added to a view.

NameTypeRequiredDescription

fieldIdstringrequiredNo description.

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

crmFieldobjectoptionalNo description.

claapmcp_update_deal_view#Update an existing deal view (saved preset). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_deal_views.8 params▾

Update an existing deal view (saved preset). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId via list_deal_views.

NameTypeRequiredDescription

viewIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

namestringoptionalNo description.

sortarrayoptionalNo description.

claapmcp_update_recording_field#Update an AI field for meeting recordings. This is a full replace: always send the complete desired definition (title, prompt, and the optional crmField); omitted optional fields are cleared. Discover fieldIds and current definitions via list_recording_fields. The field is not visible in the app until it is added to a view.5 params▾

Update an AI field for meeting recordings. This is a full replace: always send the complete desired definition (title, prompt, and the optional crmField); omitted optional fields are cleared. Discover fieldIds and current definitions via list_recording_fields. The field is not visible in the app until it is added to a view.

NameTypeRequiredDescription

fieldIdstringrequiredNo description.

promptobjectrequiredNo description.

titlestringrequiredNo description.

workspaceIdstringrequiredNo description.

crmFieldobjectoptionalNo description.

claapmcp_update_recording_view#Update an existing recording view (saved preset of meetings). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId and valid column identifiers, including AI insight fieldIds, via list_recording_views. Valid filter and sort fields are defined in the input schema of this tool.8 params▾

Update an existing recording view (saved preset of meetings). Only the provided fields are changed; omitted fields are left as-is. Pass icon as null to clear it, and description as an empty string to clear it. Discover the viewId and valid column identifiers, including AI insight fieldIds, via list_recording_views. Valid filter and sort fields are defined in the input schema of this tool.

NameTypeRequiredDescription

viewIdstringrequiredNo description.

workspaceIdstringrequiredNo description.

columnsarrayoptionalNo description.

descriptionstringoptionalNo description.

filtersobjectoptionalNo description.

iconstringoptionalNo description.

namestringoptionalNo description.

sortarrayoptionalNo description.