Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Dovetail MCP connector

Bearer TokenAIAnalytics

Connect to Dovetail, the AI-native UX research platform. Access projects, insights, and data from your AI workflows.

Dovetail MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “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. Make your first call

    Section titled “Make your first call”
    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 = 'dovetailmcp'
    const identifier = 'user_123'
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'dovetailmcp_get_dovetail_projects',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Search workspace — Perform powerful text-based search across all content types in the Dovetail workspace — projects, docs, data, highlights, and contacts
  • List users, tags, project templates — List all members of the Dovetail workspace, including their roles and contact information
  • Get user, tag, project insight — Retrieve a single workspace member’s profile by their unique identifier
  • File download — Get a short-lived presigned URL to download the raw content of a file attachment
  • Create transcript highlight, tag, project — Create a highlight on an audio or video transcript by marking a specific text range

Tool list

Section titled “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.

dovetailmcp_create_channel_datum#Send a new data point to a Dovetail channel for automated AI processing.3 params

Send a new data point to a Dovetail channel for automated AI processing.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Dovetail channel to which the data point will be sent.
contentstringrequiredThe raw text content of the data point to send (e.g. an app review, NPS response, or support ticket body).
titlestringoptionalOptional title or short label for the data point. Helps identify the item in the channel's data list.
dovetailmcp_create_comment#Post a top-level comment on a Dovetail doc. Comments are discussion threads attached to docs.2 params

Post a top-level comment on a Dovetail doc. Comments are discussion threads attached to docs.

NameTypeRequiredDescription
contentstringrequiredThe text content of the comment to post on the doc.
doc_idstringrequiredThe unique identifier of the Dovetail doc on which to post the comment.
dovetailmcp_create_data#Create a new research data entry within a Dovetail project. Data entries store raw research materials such as interview transcripts, survey responses, or notes.3 params

Create a new research data entry within a Dovetail project. Data entries store raw research materials such as interview transcripts, survey responses, or notes.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project to create the data entry in.
titlestringrequiredThe name or title of the new research data entry.
contentstringoptionalThe body content of the research data entry in markdown format. Optional — omit to create an empty entry.
dovetailmcp_create_doc#Create a new doc in the Dovetail workspace. Docs are rich-text documents used for insights, reports, and notes.4 params

Create a new doc in the Dovetail workspace. Docs are rich-text documents used for insights, reports, and notes.

NameTypeRequiredDescription
titlestringrequiredThe title of the new Dovetail doc.
contentstringoptionalInitial rich-text content for the doc, in markdown format.
folder_idstringoptionalThe unique identifier of the folder to place the doc in. If omitted, the doc is created at the root level.
project_idstringoptionalThe unique identifier of the project to create the doc within. If omitted, the doc is created outside any project.
dovetailmcp_create_folder#Create a new folder in the Dovetail workspace to organize projects, docs, and channels.2 params

Create a new folder in the Dovetail workspace to organize projects, docs, and channels.

NameTypeRequiredDescription
titlestringrequiredThe display name for the new folder.
parent_folder_idstringoptionalThe ID of the parent folder under which this new folder will be created. If omitted, the folder is created at the top level of the workspace.
dovetailmcp_create_project#Create a new project in the Dovetail workspace. Projects are the primary container for research data, docs, and insights.3 params

Create a new project in the Dovetail workspace. Projects are the primary container for research data, docs, and insights.

NameTypeRequiredDescription
titlestringrequiredThe name of the new project to create.
folder_idstringoptionalThe unique identifier of the folder to create the project in. Optional — omit to create the project at the workspace root.
template_idstringoptionalThe unique identifier of a project template to use as the starting structure for the new project. Optional.
dovetailmcp_create_tag#Create a new tag within a Dovetail project. Tags are project-scoped labels used to categorize highlights and data.3 params

Create a new tag within a Dovetail project. Tags are project-scoped labels used to categorize highlights and data.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project in which to create the tag.
titlestringrequiredThe display name for the new tag.
colorstringoptionalOptional color for the tag, used for visual differentiation in the Dovetail UI.
dovetailmcp_create_transcript_highlight#Create a highlight on an audio or video transcript by marking a specific text range.5 params

Create a highlight on an audio or video transcript by marking a specific text range.

NameTypeRequiredDescription
data_idstringrequiredThe unique identifier of the transcript data entry on which to create the highlight.
end_indexintegerrequiredThe character index in the transcript text at which the highlight ends (exclusive).
project_idstringrequiredThe unique identifier of the Dovetail project that contains the transcript data.
start_indexintegerrequiredThe character index in the transcript text at which the highlight begins (inclusive).
tag_idsarrayoptionalOptional list of tag IDs to attach to the newly created highlight.
dovetailmcp_download_file#Get a short-lived presigned URL to download the raw content of a file attachment.1 param

Get a short-lived presigned URL to download the raw content of a file attachment.

NameTypeRequiredDescription
file_idstringrequiredThe unique identifier of the file attachment for which to generate a presigned download URL.
dovetailmcp_get_channel#Retrieve detailed information about a specific channel by its unique ID, including its topics.1 param

Retrieve detailed information about a specific channel by its unique ID, including its topics.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Dovetail channel to retrieve.
dovetailmcp_get_channel_datum#Retrieve a single channel data point by its ID, including its theme classifications.2 params

Retrieve a single channel data point by its ID, including its theme classifications.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Dovetail channel that contains the data point.
datum_idstringrequiredThe unique identifier of the data point to retrieve.
dovetailmcp_get_contact#Retrieve a single contact by its unique identifier. Contacts represent research participants or customers in the Dovetail workspace.1 param

Retrieve a single contact by its unique identifier. Contacts represent research participants or customers in the Dovetail workspace.

NameTypeRequiredDescription
contact_idstringrequiredThe unique identifier of the contact to retrieve.
dovetailmcp_get_data_content#Export and retrieve the complete content of a research data entry as markdown.2 params

Export and retrieve the complete content of a research data entry as markdown.

NameTypeRequiredDescription
data_idstringrequiredThe unique identifier of the research data entry whose content you want to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project containing the data entry.
dovetailmcp_get_doc#Retrieve detailed metadata for a single Dovetail doc by its unique ID.1 param

Retrieve detailed metadata for a single Dovetail doc by its unique ID.

NameTypeRequiredDescription
doc_idstringrequiredThe unique identifier of the Dovetail doc to retrieve.
dovetailmcp_get_doc_comment#Retrieve a single comment on a Dovetail doc by its unique identifier.2 params

Retrieve a single comment on a Dovetail doc by its unique identifier.

NameTypeRequiredDescription
comment_idstringrequiredThe unique identifier of the comment to retrieve.
doc_idstringrequiredThe unique identifier of the Dovetail doc that contains the comment.
dovetailmcp_get_doc_content#Export and retrieve the complete content of a Dovetail doc in markdown format.1 param

Export and retrieve the complete content of a Dovetail doc in markdown format.

NameTypeRequiredDescription
doc_idstringrequiredThe unique identifier of the Dovetail doc whose content should be exported.
dovetailmcp_get_dovetail_projects#Browse and discover all projects in the Dovetail workspace. Projects are the primary container for research data, docs, and insights.3 params

Browse and discover all projects in the Dovetail workspace. Projects are the primary container for research data, docs, and insights.

NameTypeRequiredDescription
folder_idstringoptionalFilter projects by the folder they belong to. Optional — omit to list projects across all folders.
limitintegeroptionalMaximum number of projects to return per page. Optional.
start_cursorstringoptionalPagination cursor returned by a previous response. Pass this to retrieve the next page of results. Optional.
dovetailmcp_get_field#Retrieve a single custom field definition by its unique identifier.2 params

Retrieve a single custom field definition by its unique identifier.

NameTypeRequiredDescription
field_idstringrequiredThe unique identifier of the custom field to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project that owns the field.
dovetailmcp_get_file#Retrieve metadata for a single file attachment by its unique identifier.1 param

Retrieve metadata for a single file attachment by its unique identifier.

NameTypeRequiredDescription
file_idstringrequiredThe unique identifier of the file attachment to retrieve metadata for.
dovetailmcp_get_folder#Retrieve a single folder by its unique identifier, including its metadata.1 param

Retrieve a single folder by its unique identifier, including its metadata.

NameTypeRequiredDescription
folder_idstringrequiredThe unique identifier of the Dovetail folder to retrieve.
dovetailmcp_get_folder_contents#List all items contained directly within a specific folder — projects, docs, and channels.3 params

List all items contained directly within a specific folder — projects, docs, and channels.

NameTypeRequiredDescription
folder_idstringrequiredThe unique identifier of the folder whose contents you want to list.
limitintegeroptionalMaximum number of items to return in a single page of results. Optional.
start_cursorstringoptionalPagination cursor returned by a previous response. Pass this to retrieve the next page of results. Optional.
dovetailmcp_get_highlight#Retrieve a single highlight by its unique identifier, including its content and associated tags.2 params

Retrieve a single highlight by its unique identifier, including its content and associated tags.

NameTypeRequiredDescription
highlight_idstringrequiredThe unique identifier of the highlight to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project that contains the highlight.
dovetailmcp_get_insight_content#(Deprecated — use get_doc_content instead.) Export and retrieve the complete content of an insight in markdown format.2 params

(Deprecated — use get_doc_content instead.) Export and retrieve the complete content of an insight in markdown format.

NameTypeRequiredDescription
insight_idstringrequiredThe unique identifier of the insight whose content to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project containing the insight.
dovetailmcp_get_project#Retrieve metadata for a single Dovetail project by its unique identifier.1 param

Retrieve metadata for a single Dovetail project by its unique identifier.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project to retrieve.
dovetailmcp_get_project_data#Retrieve detailed metadata and information about a specific research data entry.2 params

Retrieve detailed metadata and information about a specific research data entry.

NameTypeRequiredDescription
data_idstringrequiredThe unique identifier of the research data entry to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project containing the data entry.
dovetailmcp_get_project_highlights#Retrieve customer feedback highlights and key quotes from a Dovetail project.3 params

Retrieve customer feedback highlights and key quotes from a Dovetail project.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project whose highlights you want to retrieve.
limitintegeroptionalMaximum number of highlights to return per page. Use with start_cursor for pagination.
start_cursorstringoptionalPagination cursor to retrieve the next page of highlights. Obtained from the previous response.
dovetailmcp_get_project_insight#(Deprecated — use get_doc instead.) Retrieve a specific insight by its unique identifier.2 params

(Deprecated — use get_doc instead.) Retrieve a specific insight by its unique identifier.

NameTypeRequiredDescription
insight_idstringrequiredThe unique identifier of the insight to retrieve.
project_idstringrequiredThe unique identifier of the Dovetail project containing the insight.
dovetailmcp_get_tag#Retrieve a single tag by its unique identifier, including its title and color.2 params

Retrieve a single tag by its unique identifier, including its title and color.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project that contains the tag.
tag_idstringrequiredThe unique identifier of the tag to retrieve.
dovetailmcp_get_user#Retrieve a single workspace member's profile by their unique identifier.1 param

Retrieve a single workspace member's profile by their unique identifier.

NameTypeRequiredDescription
user_idstringrequiredThe unique identifier of the workspace member to retrieve.
dovetailmcp_list_channel_data#List the raw data points (e.g. app reviews, NPS responses, support tickets) in a Dovetail channel.3 params

List the raw data points (e.g. app reviews, NPS responses, support tickets) in a Dovetail channel.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Dovetail channel whose data points you want to list.
limitintegeroptionalMaximum number of data points to return per page. Defaults to the server's default page size if omitted.
start_cursorstringoptionalPagination cursor returned by a previous list call. Pass this value to retrieve the next page of results.
dovetailmcp_list_channel_themes#Retrieve all AI-generated themes for a Dovetail channel. Themes are AI-generated clusters of related feedback.1 param

Retrieve all AI-generated themes for a Dovetail channel. Themes are AI-generated clusters of related feedback.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Dovetail channel whose AI-generated themes you want to retrieve.
dovetailmcp_list_channels#Browse and discover all channels in the Dovetail workspace. Channels are automated analysis pipelines processing high-volume customer feedback into structured insights.3 params

Browse and discover all channels in the Dovetail workspace. Channels are automated analysis pipelines processing high-volume customer feedback into structured insights.

NameTypeRequiredDescription
folder_idstringoptionalFilter channels by the ID of a specific folder. If omitted, channels from all folders are returned.
limitintegeroptionalMaximum number of channels to return per page. Must be between 1 and 100. Defaults to the server's default page size if omitted.
start_cursorstringoptionalPagination cursor returned by a previous list call. Pass this value to retrieve the next page of results.
dovetailmcp_list_contacts#Browse the contacts database in the Dovetail workspace. Contacts are research participants or customers linked to data entries.2 params

Browse the contacts database in the Dovetail workspace. Contacts are research participants or customers linked to data entries.

NameTypeRequiredDescription
limitintegeroptionalMaximum number of contacts to return per page. Optional.
start_cursorstringoptionalPagination cursor for fetching the next page of results. Pass the cursor returned from a previous response. Optional.
dovetailmcp_list_doc_comments#Retrieve all comments on a specific Dovetail doc, returned in chronological order.1 param

Retrieve all comments on a specific Dovetail doc, returned in chronological order.

NameTypeRequiredDescription
doc_idstringrequiredThe unique identifier of the Dovetail doc whose comments should be retrieved.
dovetailmcp_list_docs#Browse and discover all docs in the Dovetail workspace. Docs are rich-text documents used for insights, reports, and notes.4 params

Browse and discover all docs in the Dovetail workspace. Docs are rich-text documents used for insights, reports, and notes.

NameTypeRequiredDescription
folder_idstringoptionalFilter docs to only those within the specified folder.
limitintegeroptionalMaximum number of docs to return in a single response. Use with start_cursor for pagination.
project_idstringoptionalFilter docs to only those belonging to the specified project.
start_cursorstringoptionalPagination cursor returned from a previous response. Pass this value to retrieve the next page of docs.
dovetailmcp_list_fields#Retrieve all custom fields defined on a Dovetail project. Fields are user-defined metadata attributes attached to data entries.1 param

Retrieve all custom fields defined on a Dovetail project. Fields are user-defined metadata attributes attached to data entries.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project whose custom fields you want to list.
dovetailmcp_list_folders#Browse all folders in the Dovetail workspace. Folders organize projects, docs, and channels.2 params

Browse all folders in the Dovetail workspace. Folders organize projects, docs, and channels.

NameTypeRequiredDescription
limitintegeroptionalMaximum number of folders to return per page. Defaults to the server's default page size if omitted.
start_cursorstringoptionalPagination cursor returned by a previous list call. Pass this value to retrieve the next page of results.
dovetailmcp_list_personal_docs#Retrieve all docs authored by or assigned to a specific user in the Dovetail workspace.3 params

Retrieve all docs authored by or assigned to a specific user in the Dovetail workspace.

NameTypeRequiredDescription
user_idstringrequiredThe unique identifier of the user whose personal docs should be retrieved.
limitintegeroptionalMaximum number of docs to return in a single response. Use with start_cursor for pagination.
start_cursorstringoptionalPagination cursor returned from a previous response. Pass this value to retrieve the next page of docs.
dovetailmcp_list_project_data#Browse and discover all research data entries within a specific Dovetail project.3 params

Browse and discover all research data entries within a specific Dovetail project.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project whose data entries you want to list.
limitintegeroptionalMaximum number of data entries to return per page. Optional.
start_cursorstringoptionalPagination cursor returned by a previous response. Pass this to retrieve the next page of results. Optional.
dovetailmcp_list_project_insights#(Deprecated — use list_docs instead.) List insights within a Dovetail project.3 params

(Deprecated — use list_docs instead.) List insights within a Dovetail project.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project whose insights to list.
limitintegeroptionalMaximum number of insights to return per page. Optional.
start_cursorstringoptionalPagination cursor for fetching the next page of results. Pass the cursor returned from a previous response. Optional.
dovetailmcp_list_project_templates#List all project templates available in the Dovetail workspace.0 params

List all project templates available in the Dovetail workspace.

dovetailmcp_list_tags#Browse and discover tags in the Dovetail workspace, scoped to a specific project.3 params

Browse and discover tags in the Dovetail workspace, scoped to a specific project.

NameTypeRequiredDescription
project_idstringrequiredThe unique identifier of the Dovetail project whose tags you want to list.
limitintegeroptionalMaximum number of tags to return per page. Use with start_cursor for pagination.
start_cursorstringoptionalPagination cursor to retrieve the next page of tags. Obtained from the previous response.
dovetailmcp_list_users#List all members of the Dovetail workspace, including their roles and contact information.2 params

List all members of the Dovetail workspace, including their roles and contact information.

NameTypeRequiredDescription
limitintegeroptionalMaximum number of workspace members to return per page. Optional.
start_cursorstringoptionalPagination cursor for fetching the next page of results. Pass the cursor returned from a previous response. Optional.
dovetailmcp_search_workspace#Perform powerful text-based search across all content types in the Dovetail workspace — projects, docs, data, highlights, and contacts.3 params

Perform powerful text-based search across all content types in the Dovetail workspace — projects, docs, data, highlights, and contacts.

NameTypeRequiredDescription
querystringrequiredThe text search query to run across all content in the Dovetail workspace.
limitintegeroptionalMaximum number of search results to return per page. Optional.
start_cursorstringoptionalPagination cursor for fetching the next page of search results. Pass the cursor returned from a previous response. Optional.