Dovetail Plugin for OpenPets

Connect AI agents to your Dovetail workspace to search insights, analyze research data, and manage projects.

Overview

This plugin integrates with Dovetail's official MCP server to provide AI-powered access to your customer research and insights. Dovetail is a customer intelligence platform that helps teams organize, analyze, and share user research data.

Features

• List Projects: View all projects in your Dovetail workspace
• Search Workspace: Search across all content including insights, data entries, and highlights
• Get Highlights: Retrieve highlights from specific projects
• Analyze Insights: Access detailed insight content in markdown format
• Browse Data: List and retrieve data entries with their content

Setup

1. Get Your API Token

1. Navigate to Settings → Account in Dovetail
2. Look for Personal API keys
3. Generate a new token
4. Copy the token for use in the next step

2. Configure Environment Variables

Create a .env file in this directory:

cp .env.example .env

Edit .env and add your API token:

DOVETAIL_API_TOKEN=your_dovetail_api_token_here

3. Install Dependencies

From the project root:

bun install

Usage

Test Connection

pets run dovetail --query "test dovetail connection"

List Projects

pets run dovetail --query "list my Dovetail projects"

Search Workspace

pets run dovetail --query "search for insights about user onboarding"

Get Project Highlights

pets run dovetail --query "get highlights from project <project-id>"

Available Tools

| Tool | Description | |------|-------------| | dovetail-test-connection | Verify API token and list accessible projects | | dovetail-list-projects | List all projects in your workspace | | dovetail-search-workspace | Search across all content | | get_dovetail_projects | MCP: List projects | | get_project_highlights | MCP: Get highlights for a project | | list_project_insights | MCP: List insights in a project | | get_project_insight | MCP: Get specific insight details | | get_insight_content | MCP: Get insight content as markdown | | list_project_data | MCP: List data entries | | get_project_data | MCP: Get specific data entry | | get_data_content | MCP: Get data content as markdown |

Rate Limits

Dovetail API has a rate limit of 200 requests per minute per workspace. The plugin handles rate limiting gracefully and will retry requests when possible.

Authentication

This plugin uses Bearer token authentication with your Dovetail personal API key. The token is sent in the Authorization header for all API requests.

Data Access

The plugin can only access data that your user account has permission to view. Data you do not have access to and actions that aren't available to your user role will not be available through the API.

Support

• Dovetail API Documentation: https://developers.dovetail.com/docs
• Dovetail API Reference: https://developers.dovetail.com/reference
• Dovetail Slack #api channel: https://join.slack.com/t/heydovetail/shared_invite

Resources

• Dovetail Homepage
• Dovetail Developer Docs
• Dovetail MCP Server Docs

License

MIT