← All integrations

Dovetail MCP server

51 operations0 webhooks

Customer research platform for managing projects, notes, highlights, insights, data, docs, folders, tags, contacts, channels, and files.

Try Dovetail with your agent

Connect Dovetail, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.

Using Corsair, show me what you can do in Dovetail on my account, then run one read-only example and show me the result.

Runs once, when you ask

Dovetail tools and triggers

Tools are what your agent can do in Dovetail through Corsair's MCP server. Triggers are the Dovetail events a routine can start from.

Docs

  • CreateWrite

    Tool to create a doc in a Dovetail project with text content, title and/or custom fields. Use when you need to document research findings, store notes, or create structured content within a project. The doc content is stored but not returned in the response.

    docs.create

  • DeleteDestructive

    Tool to delete an existing doc. Use when you need to remove a doc and move it to the project's trash (restorable for 30 days).

    docs.delete

  • ExportRead-only

    Tool to export a doc in HTML or Markdown format. Use when you need to retrieve the full content of a doc from Dovetail in a specific format.

    docs.export

  • GetRead-only

    Tool to retrieve details of a specific doc by ID. Use when you have confirmed the doc ID and need full doc metadata from Dovetail.

    docs.get

  • Import FileWrite

    Tool to import a public file URL as a new doc in Dovetail. Use when you need to create a doc from an external file source. The file must be publicly accessible at the provided URL.

    docs.importFile

  • ListRead-only

    Tool to list docs in a Dovetail workspace with optional filtering, sorting, and pagination. Use when you need to retrieve docs, optionally filtered by project, title, content, or creation date.

    docs.list

  • List User DocsRead-only

    Tool to get a list of docs associated with a user in Dovetail. Use when you need to retrieve documents for a specific user or the authenticated user (use 'me' as user_id).

    docs.listUserDocs

  • UpdateWrite

    Tool to update a doc in Dovetail. Use when you need to modify a doc's title or custom fields.

    docs.update

Insights

  • CreateWrite

    Creates a new insight in Dovetail to store synthesized research findings, observations, or conclusions. Use this tool when you need to document and save key findings from user research, interviews, or data analysis. Insights can optionally be linked to a project for better organization. Returns the created insight's ID, title, creation timestamp, and other metadata. Note: The body content is stored but not included in the response.

    insights.create

  • DeleteDestructive

    Tool to delete an existing insight. Use when you have confirmed the insight ID and want to move it to trash (restorable for 30 days).

    insights.delete

  • ExportRead-only

    Tool to export an insight in HTML or Markdown format. Use when you need to retrieve the full content of an insight for documentation, reporting, or sharing purposes. The exported content includes the insight's title and body in the specified format.

    insights.export

  • GetRead-only

    Tool to retrieve details of a specific insight by ID. Use when you need full insight metadata from Dovetail.

    insights.get

Connect Dovetail to Claude, ChatGPT or Cursor

  1. 1

    Connect Dovetail in Corsair

    Add your Dovetail API key once in Corsair. Corsair stores the credential encrypted and makes the Dovetail API calls for your agent, so it never goes into a prompt or a config file. Connect Dovetail

    If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Dovetail. On a ChatGPT personal plan, connect Dovetail here first.

  2. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client

  3. 3

    Sign in and choose what needs your approval

    Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Dovetail's read and write operations run right away and its 6 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.

FAQ

Install corsair and @corsair-dev/dovetail, add the Dovetail plugin, and connect with an API key. Then call methods like corsair.dovetail.api.channels.create() from your app. Corsair syncs data per tenant.

Yes. Dovetail requires an API key from your Dovetail account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.

Yes. One Corsair client can hit Dovetail, GitHub, Notion, Stripe, and the rest. Trigger Dovetail from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.

Teams use Corsair for customer research platform for managing projects, notes, highlights, insights, data, docs, folders, tags, contacts, channels, and files. Common builds include sync jobs, admin tooling, and agents that call Dovetail APIs from your backend. Local DB entities let you query synced Dovetail records without hitting the API on every read.

The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Dovetail API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.

We maintain @corsair-dev/dovetail in the open repo. When Dovetail ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.

No. Corsair does not read your Dovetail data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Dovetail data on your behalf.

Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.

Yes. Put Dovetail on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 6 destructive Dovetail operations. You can change a link's mode at hub.corsair.dev/me.