How to connect Harmonic with ChatGPT

Connect ChatGPT 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

How to connect Harmonic MCP with ChatGPT

ChatGPT can take action across your apps and files, stay with a project for hours, and turn a goal into finished materials like sheets, slides, and docs, not just answers.

In this guide, I will explain the easiest and most secure way to connect your Harmonic account to ChatGPT via Composio Connect, so it can find companies, enrich profiles, discover people, run saved searches, and manage workspaces through natural language commands without ever putting your account credentials at risk.

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

Also integrate Harmonic with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's Harmonic integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
  • 1,700+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
  • Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
  • Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

Prerequisites

Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.

Step-by-step: Connect Harmonic to ChatGPT

1. Install the Composio plugin

Click the button. ChatGPT opens the Composio plugin page. Click Install plugin.

Install in ChatGPT

Composio plugin page in ChatGPT with the Install plugin button

You can also find it inside ChatGPT: go to Settings, open Plugins, search the marketplace for Composio, and click Install plugin.

2. Authenticate

After you install, ChatGPT asks you to authenticate with Composio. Log in and click Allow access to authorize ChatGPT to use your Composio account.

Composio login and Allow access screen for ChatGPT

3. Start using Composio

That is it. Composio tools are now available in ChatGPT. Type @Composio followed by your request, for example @Composio find unread Harmonic messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize Harmonic.

Option 2: Add Composio as an MCP server

If you cannot use the plugin marketplace, add Composio as a custom MCP server instead.

1. Open the MCP settings

In ChatGPT, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.

ChatGPT settings showing the Plugins page with the MCP tab selected

2. Add the server

Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
ChatGPT Add server dialog with the name Composio, type Streamable HTTP, and the Composio MCP URL

Then click Save. The Composio server now appears in your MCP plugins list.

ChatGPT Plugins page showing the Composio MCP server added to the list

3. Authenticate

Click Authenticate on the Composio entry, log in via Composio, and click Allow access. Composio tools are then available in ChatGPT the same way as with the plugin.

What you can do after connecting Harmonic

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

Security + privacy notes (important)

  • Use least-privilege access: Only grant permissions you actually need.
  • Review OAuth permissions before approving: Make sure requested scopes match what you expect Composio and ChatGPT to do.
  • Keep write actions human-reviewed: For actions like sending messages, creating labels, or editing drafts, keep manual confirmation enabled.
  • Be careful with sensitive data: Avoid using this setup with highly sensitive information unless allowed by your personal, company, or client policies.
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