How to connect Harmonic to Claude

Connect Claude Web, Desktop and Cowork to Harmonic MCP. Find startups matching your investment criteria, enrich a company profile with firmographics, and more using natural language, with authentication handled for you.

Harmonic logoHarmonic
Api Key

Harmonic is a company and people data platform for discovering and enriching business contacts. It helps go-to-market and investment teams find prospects, research markets, and manage saved searches.

76 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Harmonic account to Claude via Composio Connect, enabling it to find startups matching your investment criteria, enrich a company profile with firmographics, search people by role and location, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Harmonic with

Connecting Harmonic to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Harmonic account

Back in Claude, ask it to connect to Harmonic or give it any Harmonic-related task.

For example, ask Claude to:

  • "Find startups matching your investment criteria"
  • "Enrich a company profile with firmographics"
  • "Search people by role and location"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Harmonic account is ready to use.

What is the Harmonic Claude Connector, and what's possible with it?

The Harmonic MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Harmonic account. It provides structured and secure access to company and people data, enrichment, saved searches, and workspace operations, so your agent can find and enrich companies and people, create research tasks, organize workspace records, and export business data on your behalf.

  • Company and people research: Have your agent retrieve company and person records, look up multiple records at once, and enrich companies from web or social identifiers or people from LinkedIn profiles and email addresses.
  • Saved searches and discovery: Direct your agent to create saved searches, clear net-new results, and start Scout research tasks for go-to-market or investment workflows.
  • Workspace list management: Let the agent create lists, add or remove company and person entries, define custom fields, and delete lists or list attributes when they are no longer needed.
  • Workspace views and data exports: Instruct your agent to create named views and export lists, views, or record types as CSV files using selected columns and filters.
  • Imports and record files: Have your agent start imports of up to 1,000 rows, check import results, upload files to workspace records, and manage attached files.

Troubleshooting

1. Why does Claude not use the Composio connector for Harmonic?

The connector can show as connected, but Claude must use it in each Harmonic conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Harmonic again.

2. Why does Claude show an MCP server error before Harmonic connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Harmonic.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Harmonic.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Harmonic authorization link not work?

The Composio connector is one server. Your Harmonic account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Harmonic connection.
  • Composio creates a fresh Harmonic authorization link.
  • Open that link in your browser and finish the Harmonic sign-in.

4. Why do Harmonic actions fail after they worked before?

The Harmonic connection can expire or lose permission.

  • Ask Claude to inspect the Harmonic connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Harmonic account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Harmonic.
  • If the action still fails with a permission error, check that the connected account has that permission in Harmonic itself.

5. How do I switch to a different Harmonic account?

Claude can manage the Harmonic connection for you.

  • Ask Claude to disconnect or delete the current Harmonic account.
  • Ask Claude to connect Harmonic again.
  • Open the new Composio authorization link for Harmonic.
  • Sign in with the other Harmonic account in the browser.
  • After the account connects, ask Claude to retry the Harmonic task.

6. Why is my Harmonic connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Harmonic connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Harmonic tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Harmonic.
TOOLS

Supported Tools

Every Harmonic action and event your agent gets out of the box.

Batch Delete Company Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Batch Delete Investor Attachments

Delete multiple investor attachments and return the deleted count.

Batch Delete Person Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Batch Get Companies

Return up to 500 Harmonic companies by numeric IDs and company URNs using the JSON-body batch endpoint.

Batch Get Investor Attachments

Return attachment metadata for Harmonic investors.

Batch Get Persons

Return up to 500 Harmonic people by numeric IDs and person URNs using the JSON-body batch endpoint.

Batch Get Workspace Records

Fetch documented core fields and requested typed attribute values for multiple Workspace records of one record type.

Clear Saved Search Net-New Results

Clear net-new state for selected company or person URNs in a shared saved search.

Complete Investor Attachment Uploads

Finalize investor attachments after their bytes were sent to upload_uri values returned by initiation.

Create Import

Start an asynchronous import of up to 1,000 rows into exactly one list or record type.

Create List

Create a shared Workspace list for one record type.

Create Workspace List Attribute

Create a list-entry field from the documented metadata subset: numeric, currency, traction, select, status, or owner reference.

Create List Entries

Copy one explicit or filtered selection into a target list.

Create List Entry

Add one record to a Workspace list and optionally set values.

Create Named View

Create a saved Workspace view for exactly one list or record type.

Create Record Attachment

Upload one file of at most 500 MB to a Workspace record.

Create Workspace Record Attribute

Create a record-level field from the documented metadata subset: numeric, currency, traction, select, status, or owner reference.

Create Saved Search

Create a Harmonic saved search from an exact recursive filter, pagination, sort, and column-view configuration.

Create Scout Task

Create a Scout research task and immediately return its task_id and non-terminal status.

Delete Investor Attachment

Delete one investor attachment.

Delete List

Delete a shared Workspace list.

Delete Workspace List Attribute

Permanently delete a custom list attribute by URN.

Delete List Entries

Remove an explicit or filtered selection of memberships from one list.

Delete List Entry

Remove one membership from a Workspace list.

Delete Named View

Permanently delete a Workspace named view.

Delete Record Attachment

Permanently delete a file attached to a Workspace record.

Delete Workspace Record Attribute

Permanently delete a custom record attribute by URN.

Enrich Company

Find a company from web or social identifiers.

Enrich Person

Find a person by LinkedIn profile URL, with email used as a fallback.

Export List CSV

Stream a Workspace list as CSV using selected columns and optional documented filters and sorts.

Export Named View CSV

Stream a saved Workspace named view as CSV using its stored columns, filter, and sorts.

Export Record Type CSV

Stream Workspace records of one record type as CSV using selected columns and optional documented filters and sorts.

Get Bulk Email Enrichment Job

Read one paid bulk email enrichment job and its credit-consuming work status.

Get Bulk Email Enrichment Usage

Return the paid bulk email enrichment product's current monthly credit usage, limit, and remaining balance.

Get Companies

Return up to 50 Harmonic companies by numeric IDs and company URNs using the repeated-query GET endpoint.

Get Company

Return one Harmonic company by its numeric ID, UUID, or company URN.

Get Company User Connections

Return the workspace users connected to a Harmonic company and the email, calendar, or LinkedIn sources establishing each connection.

Get Enrichment Status

Check enrichment jobs by enrichment UUID or enrichment URN and return their current statuses.

Get Import Task

Poll an asynchronous Workspace import and return one optionally status-filtered Relay page of row results.

Get Investor Attachment Content

Return Harmonic's short-lived content URL as a downloadable file reference.

Get Named View

Return a saved Workspace view's documented filter, columns, sorts, default state, and owning list or record type.

Get Person

Return one Harmonic person by numeric ID, UUID, or person URN, optionally using company URNs to provide company context.

Get Persons

Return up to 50 Harmonic people by numeric IDs and person URNs using the repeated-query GET endpoint.

Get Record Type

Return a Workspace record type, its documented attributes, and one Relay page of records.

Get Saved Search Net-New Results

Return one page of entities newly matching a shared Harmonic saved search.

Get Saved Search Results

Return one page of company, person, user, or investor results from a saved search, optionally hydrated into entity objects.

Get Scout API Usage

Return one page of usage for existing Scout API runs.

Get Scout Task

Poll an existing Scout task until its status is terminal.

Get Similar Companies

Return Harmonic company URNs ranked as similar to a source company.

Get Workspace

Return the connected team's Workspace identity, built-in record types, and documented Harmonic attribute catalogs.

Get Workspace List

Return list metadata and one filtered, sorted Relay page of entries.

Get Workspace List Entry

Return one list membership, its underlying record, and explicitly requested typed attribute values.

Get Workspace Record

Return one scoped Workspace record with requested typed values, one attachment page, and documented update-event fields.

Initiate Investor Attachment Uploads

Create attachment metadata and presigned upload destinations for an investor.

Link Company Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Link Investor Attachments

Link uploaded attachments to an investor.

Link Person Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

List Company Employees

Return one page of person URNs associated with a company, filtered by employee group, status, or connection status.

List Saved Searches

Return the saved searches visible to the API key's team.

Reconnect Scout Task Stream

Reconnect to a Scout text/event-stream using the task_id emitted by the first event of STREAM_SCOUT_TASK.

Run Scout Task and Wait

Create a Scout research task, hold the connection until it finishes, and return markdown or json_schema-structured content.

Search Companies by Keywords

Search Harmonic companies with explicit keyword inclusion and exclusion fields.

Search Typeahead

Return Harmonic typeahead suggestions for companies, people, investors, schools, users, or locations.

Search with Agent

Search companies from a natural-language request and return Harmonic's parsed query interpretation.

Stream Scout Task

Create a Scout task, capture its mandatory first SSE task_id event, and close the initial stream immediately so the paid task is recoverable.

Submit Bulk Email Enrichment Job

Submit 1-5,000 people for paid bulk email enrichment using exactly one identifier array.

Update List

Rename a shared Workspace list.

Update Workspace List Attribute

Rename a Workspace list attribute and/or update its documented numeric, currency, traction, select, or status metadata.

Update List Entries

Set supplied attribute values on an explicit or filtered selection of list memberships.

Update List Entry

Update only the supplied attribute values on one list membership.

Update Named View

Update provided fields on a Workspace named view.

Update Workspace Record

Update only the supplied record-level values and/or shared team note.

Update Record Attachment

Rename a file attached to a Workspace record; file content is unchanged.

Update Workspace Record Attribute

Rename a Workspace record attribute and/or update its documented numeric, currency, traction, select, or status metadata.

Update Workspace Records

Set record-level attribute values across one explicit or filtered Workspace selection.

Update Workspace Team Note

Set or clear a shared record note using a record URN or Harmonic entity URN.

FRAMEWORKS

How to build Harmonic MCP Agent with another framework

FAQ

Frequently asked questions

Start with Harmonic.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Harmonic tool your agent needs.Free to start.

Start building