How to connect Freshsales with ChatGPT

Connect ChatGPT to Freshsales MCP. List open freshsales deals closing this month, create contacts from this sales prospect list, and more using natural language, with authentication handled for you.

Freshsales logoFreshsales
Api KeyOauth2

Freshsales is a CRM platform for managing contacts, accounts, deals, and sales activities. It helps sales teams personalize engagement and shorten the sales cycle.

104 Tools

How to connect Freshsales 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 Freshsales account to ChatGPT via Composio Connect, so it can manage contacts, track deals, update accounts, log activities, and find sales data through natural language commands without ever putting your account credentials at risk.

Also integrate Freshsales with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's Freshsales integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
  • 1,500+ 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 Freshsales 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 Freshsales messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize Freshsales.

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 Freshsales

  • List open Freshsales deals closing this month
  • Create contacts from this sales prospect list
  • Update overdue Freshsales deals with follow-up notes

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 Freshsales action and event your agent gets out of the box.

Add Marketing List Contacts

Add contacts to a Freshsales marketing list.

Bulk Assign Contact Owner

Replace the owner of up to 100 Freshsales contacts using explicit contact and owner IDs.

Bulk Assign CPQ Record Owners

Queue one owner assignment for selected CPQ products or documents; acknowledgment does not prove completion.

Bulk Delete CPQ Records

Queue soft deletion of selected CPQ products or documents so they remain restorable; acknowledgment does not prove completion.

Bulk Restore CPQ Records

Queue restoration of selected soft-deleted CPQ products or documents using the PUT methods in Freshsales' official cURL examples; acknowledgment does not prove completion.

Bulk Update CPQ Records

Queue one shared-field update for selected CPQ products or documents.

Clone Contact

Create a new Freshsales contact by cloning an existing contact and applying field overrides.

Clone Custom Module Record

Create a new Freshsales custom-module record by cloning an existing record and applying field overrides.

Clone Deal

Clone a Freshsales deal, optionally overriding fields on the new deal.

Clone Sales Account

Clone a Freshsales sales account, optionally overriding fields on the new account.

Create Appointment

Create a Freshsales appointment, optionally linked to a CRM record or attendees, and return its ID and related records.

Create Contact

Create a Freshsales contact identified by email addresses, mobile number, Twitter username, or external ID and return its ID and contact fields.

Create CPQ Document

Create a Freshsales quote or other CPQ document and return its confirmed ID.

Create Custom Field

Create a persistent custom field on one explicit Freshsales entity form.

Create Custom Module

Create a tenant-wide Freshsales custom-module definition and return its ID and internal entity name.

Create Custom Module Record

Create one record in a named Freshsales custom module and return its record ID and fields.

Create Deal

Create a Freshsales deal associated with exactly one existing or new sales account.

Create Document Link

Attach a web document URL to one explicit Freshsales CRM record.

Create Marketing List

Create an empty Freshsales marketing list.

Create Note

Create a Freshsales note on one lead, contact, sales account, or deal.

Create CPQ Product

Create a Freshsales CPQ product and return the provider-confirmed product ID.

Create Sales Account

Create a Freshsales sales account with standard, parent-account, or tenant-defined fields.

Create Sales Activity

Create a Freshsales sales activity with all provider-mandatory time, owner, type, and CRM-target fields.

Create Task

Create a Freshsales task with every provider-mandatory assignment, due-date, and CRM-target field.

Delete Appointment

Delete one Freshsales appointment by ID.

Delete Contacts

Delete one or more Freshsales contacts through ordinary deletion rather than permanent forget.

Delete CPQ Document

Soft-delete one Freshsales CPQ document so it can be restored.

Delete Custom Module

Delete a Freshsales custom-module definition and change the tenant's CRM schema.

Delete Custom Module Records

Delete one or more records from a named Freshsales custom module through ordinary deletion.

Delete Deals

Ordinarily delete one deal or bulk-delete multiple deals.

Permanently Delete Note

Permanently delete one Freshsales note.

Delete CPQ Product

Soft-delete one Freshsales CPQ product so it can be restored.

Delete Sales Accounts

Ordinarily delete one account or bulk-delete multiple accounts.

Delete Sales Activity

Delete one Freshsales sales activity after confirming the provider success code.

Delete Task

Delete one Freshsales task and return provider-confirmed deletion fields.

Permanently Forget Contact

Permanently and irreversibly erase one Freshsales contact and associated data.

Permanently Forget CPQ Document

Permanently and irreversibly delete one CPQ document and all associated data.

Permanently Forget Custom Module Record

Permanently and irreversibly erase one Freshsales custom-module record and associated data.

Permanently Forget Deal

IRREVERSIBLE: permanently erase one Freshsales deal and associated data.

Permanently Forget Sales Account

IRREVERSIBLE: permanently erase one Freshsales sales account and associated data.

Get Appointment

Return one Freshsales appointment and its related attendees, users, conferences, and notes.

Get Contact

Return one Freshsales contact by ID, optionally including related resources.

Get CPQ Document

Get one Freshsales CPQ document, optionally including product line items.

Get Custom Module

Return one Freshsales custom-module definition by ID, including the entity name required by custom-module record tools.

Get Custom Module Record

Return one record by ID from a named Freshsales custom module.

Get Deal

Get one Freshsales deal by ID, optionally with related resources.

Get Bulk Upsert Job Status

Get bounded, single-request progress and failure details for one Freshsales bulk-upsert job; this does not poll.

Get CPQ Product

Get one Freshsales CPQ product, optionally including pricing.

Get Sales Account

Get one Freshsales sales account by ID, optionally with related resources.

Get Sales Activity

Get one Freshsales sales activity by ID.

Get Task

Get one Freshsales task by ID, optionally with collaborators and its CRM target.

List Appointments

Return one page selected by Freshsales's required appointment filter.

List Configuration Options

List one Freshsales configuration option family for IDs needed by CRM operations.

List Contact Activities

Return activity history for one Freshsales contact.

List Contact Document Associations

List the file and web-link associations attached to one Freshsales contact, including referenced links, users, and provider totals.

List Contact Fields

List Freshsales contact field definitions, internal names, types, choices, and tenant form metadata for use in contact create and update calls.

List Contacts by View

Return one explicitly numbered page from a saved Freshsales contact view, including shaped page totals and the next page number when available.

List Contact Views

List saved Freshsales contact views and their IDs for use with contact listing tools.

List CPQ Document Related Products

List the typed product records associated with one Freshsales CPQ document.

List Custom Module Records

Return one saved-view page of records from a named Freshsales custom module and a page cursor when more records are available.

List Custom Module Views

List saved views for a Freshsales custom module and return the view IDs needed to list its records.

List Deal Fields

List standard and tenant-defined Freshsales deal field definitions.

List Deals by View

Return one numbered page from a saved Freshsales deal view.

List Deal Views

List saved Freshsales deal views and their IDs.

List Entity Forms

List Freshsales forms for a standard or custom entity so callers can obtain an explicit form ID before creating a custom field.

List Marketing List Contacts

Return one documented page of contacts in a Freshsales marketing list.

List Marketing Lists

Return one documented page of Freshsales marketing lists.

List Sales Account Fields

List standard and tenant-defined Freshsales sales-account field definitions.

List Sales Accounts by View

Return one numbered page from a saved Freshsales sales-account view.

List Sales Account Views

List saved Freshsales sales-account views and their IDs.

List Sales Activities

Return one bounded Freshsales sales-activity page (25 records by default, 100 maximum) and an explicit next page number.

List Sales Activity Fields

List standard and tenant-defined Freshsales sales-activity field definitions.

List Tasks

Return one page of Freshsales tasks for exactly one status or due-date filter.

Log Phone Call for Existing Record

Create an irreversible manual call log for one existing Freshsales lead, contact, or sales account and optionally create a note.

Log Phone Call for New Record

Create a new Freshsales contact and an irreversible manual call log associated with it, optionally with a note.

Lookup Records by Exact Field

Look up exact matches across one or more Freshsales lead, contact, sales-account, or deal types using one compatible standard or custom field.

Move Marketing List Contacts

Move selected contacts or every contact from one Freshsales marketing list to a different destination list.

Remove Marketing List Contacts

Remove selected contacts or every contact from one Freshsales marketing list.

Restore CPQ Document

Restore one soft-deleted Freshsales CPQ document.

Restore CPQ Product

Restore one soft-deleted Freshsales CPQ product.

Search Contacts by Exact Filters

Find exact-match Freshsales contacts with explicit field/operator/value rules.

Search Records

Fuzzy-search Freshsales users, standard CRM records, and custom-module records in one bounded request.

Start Bulk Contact Upsert

Start an asynchronous upsert of up to 100 Freshsales contacts.

Start Bulk Deal Upsert

Start an asynchronous upsert of up to 100 deals.

Start Bulk Sales Account Upsert

Start an asynchronous upsert of up to 100 sales accounts.

Update Appointment

Update selected fields or attendees on an existing Freshsales appointment and return the updated appointment and related records.

Update Contact

Update selected fields on an existing Freshsales contact and return the updated contact.

Update Contact Team Memberships

Add, update, or remove Freshsales contact-team memberships using explicit contact, user, and designation IDs.

Update CPQ Document

Update document fields or replace its complete product list through the one official PUT contract.

Update Custom Module

Update selected display, icon, navigation, or description settings on an existing Freshsales custom-module definition.

Update Custom Module Record

Update selected fields on one record in a named Freshsales custom module and return the updated record.

Update Deal

Update a Freshsales deal, its contact associations, or replace all deal products.

Update Deal Team Memberships

Add, update, or remove team memberships for one Freshsales deal.

Update Marketing List

Rename an existing Freshsales marketing list.

Update Note

Replace the text and target association of an existing Freshsales note.

Update CPQ Product

Update product fields or add, overwrite, and delete product prices through the one official PUT contract.

Update Sales Account

Update standard or tenant-defined fields on a Freshsales sales account.

Update Sales Account Team Memberships

Add, update, or remove team memberships for one Freshsales sales account.

Update Sales Activity

Update selected fields on one existing Freshsales sales activity.

Update or Mark Task Done

Update a Freshsales task through the single documented PUT path; set status=1 to mark it completed or status=0 to reopen it.

Upload and Attach Document

Upload a required file as multipart/form-data and attach it to one explicit Freshsales CRM record.

Upsert Contact

Create or update one Freshsales contact matched by a unique identifier and return the resulting contact.

Upsert Deal

Create or update a deal by one unique standard or tenant-defined field.

Upsert Sales Account

Create or update a sales account by one unique standard or tenant-defined field.

FAQ

Frequently asked questions

With a standalone Freshsales MCP server, the agents and LLMs can only access a fixed set of Freshsales tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Freshsales and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. ChatGPT fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Freshsales tools.

Yes, absolutely. You can configure which Freshsales scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Freshsales data and credentials are handled as safely as possible.

Start with Freshsales.It takes 30 seconds.

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

Start building