{"id":"io.usefulapi/freshsales","slug":"io-usefulapi-freshsales","title":"Freshsales MCP by usefulapi","description":"Manage Freshsales contacts, accounts, deals, tasks and appointments; add notes.","version":"1.20.4","publisher":{"kind":"domain","id":"usefulapi.io","label":"usefulapi.io","url":"https://usefulapi.io"},"website":"https://usefulapi.io/freshsales/","repository":"https://github.com/m190/usefulapi-mcp","remotes":[{"type":"streamable-http","url":"https://freshsales.usefulapi.io/mcp"}],"packages":[],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1318,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"freshsales_list_contact_views","title":"List contact views","description":"List the saved contact views (filters) of the account, e.g. 'My Contacts', 'New Contacts', 'All Contacts'. A view id is needed by freshsales_list_contacts; ids differ per account. GET /contacts/filters.","read_only":true},{"name":"freshsales_list_contacts","title":"List contacts","description":"List the contacts in a view (get view_id from freshsales_list_contact_views), 25 per page with name, email, phone numbers, job title, lead score, open deals amount and last contacted. Pages: use next_page. GET /contacts/view/{view_id}.","read_only":true},{"name":"freshsales_get_contact","title":"Get contact","description":"One contact by id with all its fields, optionally with related records embedded via include (notes, tasks, appointments, deals, sales_accounts, owner, sales_activities...). GET /contacts/{id}.","read_only":true},{"name":"freshsales_search","title":"Search records","description":"Search by name/email text across one record type: contact, lead (accounts with the Leads module), sales_account (company), deal or user. Returns id, type, name and email for the matches (up to per_page, default 10). Phone numbers are not a documented search field. Use the id with the get tools. GET /search.","read_only":true},{"name":"freshsales_lookup","title":"Look up by exact field","description":"Exact-match lookup of contacts, leads, companies or deals by one field, e.g. a contact by email address. field is 'email' (contacts, leads), 'name', 'company_name' (leads), or a custom field name (cf_...). Returns the full records. GET /lookup.","read_only":true},{"name":"freshsales_export_contacts","title":"Export contacts","description":"Read every contact of a view in ascending id order, up to 100 per call (fewer when the records are large), for a backup or a full export. Use the 'All Contacts' view id from freshsales_list_contact_views. Pass the reply's last_fetched_id to get the next part until has_next_page is false. Each call uses one request of the account's 1000 per hour. GET /contacts/scroll/{view_id}.","read_only":true},{"name":"freshsales_delete_contact","title":"Delete contact","description":"DESTRUCTIVE: delete ONE contact by id, only when its field match_field has exactly the value match_value (e.g. a cf_ custom field or email). The tool first reads the contact with its deals, tasks, appointments and notes. A contact with linked deals is refused unless allow_linked_deals is true. Without confirm=true nothing is deleted: the reply is a preview of the match and the linked records. With","read_only":false},{"name":"freshsales_list_lead_views","title":"List lead views","description":"List the saved lead views of an account that has the Leads module, e.g. 'My Leads', 'New Leads', 'Unassigned Leads'. A view id is needed by freshsales_list_leads. GET /leads/filters.","read_only":true},{"name":"freshsales_list_leads","title":"List leads","description":"List the leads in a view (get view_id from freshsales_list_lead_views), 25 per page. Pages: use next_page. GET /leads/view/{view_id}.","read_only":true},{"name":"freshsales_get_lead","title":"Get lead","description":"One lead by id with all its fields (name, email, phone numbers, company, lead stage, custom fields), optionally with related records via include (owner, source, lead_stage, notes, tasks, appointments...). GET /leads/{id}.","read_only":true},{"name":"freshsales_list_account_views","title":"List account views","description":"List the saved account (company) views of the account, e.g. 'My Accounts'. A view id is needed by freshsales_list_accounts. GET /sales_accounts/filters.","read_only":true},{"name":"freshsales_list_accounts","title":"List accounts","description":"List the accounts (companies) in a view (view_id from freshsales_list_account_views), 25 per page, with name, location, open deals amount and last contacted. GET /sales_accounts/view/{view_id}.","read_only":true},{"name":"freshsales_get_account","title":"Get account","description":"One account (company) by id with its fields, optionally with related records embedded (contacts, deals, tasks, appointments, owner...). GET /sales_accounts/{id}.","read_only":true},{"name":"freshsales_list_deal_views","title":"List deal views","description":"List the saved deal views of the account, e.g. 'Open Deals'. A view id is needed by freshsales_list_deals. GET /deals/filters.","read_only":true},{"name":"freshsales_list_deals","title":"List deals","description":"List the deals in a view (view_id from freshsales_list_deal_views), 25 per page, with name, amount, expected close, probability and age. GET /deals/view/{view_id}.","read_only":true},{"name":"freshsales_get_deal","title":"Get deal","description":"One deal by id with amount, expected close, probability and ids of its stage, pipeline and owner, optionally with related records embedded (contacts, sales_account, deal_stage, owner, notes via sales_activities...). GET /deals/{id}.","read_only":true},{"name":"freshsales_list_tasks","title":"List tasks","description":"List tasks by status filter: open, due_today, due_tomorrow, overdue or completed (one filter per call). Returns title, due date, owner and status. GET /tasks.","read_only":true},{"name":"freshsales_get_task","title":"Get task","description":"One task by id. GET /tasks/{id}.","read_only":true},{"name":"freshsales_list_appointments","title":"List appointments","description":"List appointments that are open (upcoming) or complete (one filter per call), with title, time, location and creator. GET /appointments.","read_only":true},{"name":"freshsales_get_appointment","title":"Get appointment","description":"One appointment by id with its attendees. GET /appointments/{id}.","read_only":true},{"name":"freshsales_list_sales_activities","title":"List sales activities","description":"List logged sales activities (calls, meetings, emails...) of the account. Requires the user's sales-activity permissions and the corresponding account feature. If HTTP 403 is returned, check those permissions before retrying. For one known contact or deal, its get tool also supports include=[\"sales_activities\"], subject to the user's access rights. GET /sales_activities.","read_only":true},{"name":"freshsales_list_owners","title":"List owners (users)","description":"List the users of the account (id and name). Use the id as owner_id when creating or updating records. GET /selector/owners.","read_only":true},{"name":"freshsales_list_deal_pipelines","title":"List deal pipelines","description":"List the deal pipelines (id, name). GET /selector/deal_pipelines.","read_only":true},{"name":"freshsales_list_deal_stages","title":"List deal stages","description":"List deal stages (id, name, deal_pipeline_id): those of the default pipeline, or of the pipeline given by pipeline_id. Use the id as deal_stage_id. GET /selector/deal_stages or /selector/deal_pipelines/{id}/deal_stages.","read_only":true},{"name":"freshsales_list_options","title":"List option values","description":"List the configured choices (id and name) for a field: lead_sources, contact_statuses, lifecycle_stages, deal_types, deal_reasons, deal_products, deal_payment_statuses, territories, currencies, industry_types, business_types, campaigns, sales_activity_types, sales_activity_outcomes. Use the ids in the *_id fields of the write tools. GET /selector/{kind}.","read_only":true},{"name":"freshsales_create_contact","title":"Create contact","description":"WRITE: create a contact. Freshsales requires an email or a mobile number. It may create a duplicate of an existing contact: search first (freshsales_lookup by email). POST /contacts.","read_only":false},{"name":"freshsales_update_contact","title":"Update contact","description":"WRITE: change fields of an existing contact; only the fields you pass are changed (passing sales_accounts replaces the associated companies). PUT /contacts/{id}.","read_only":false},{"name":"freshsales_create_account","title":"Create account","description":"WRITE: create an account (company). name is required. It may duplicate an existing company: search first (freshsales_search). POST /sales_accounts.","read_only":false},{"name":"freshsales_update_account","title":"Update account","description":"WRITE: change fields of an existing account (company); only the fields you pass are changed. PUT /sales_accounts/{id}.","read_only":false},{"name":"freshsales_create_deal","title":"Create deal","description":"WRITE: create a deal. name, amount and sales_account_id are required; contact_ids attach existing contacts. Stage and pipeline default to the first of the default pipeline. POST /deals.","read_only":false},{"name":"freshsales_update_deal","title":"Update deal","description":"WRITE: change fields of an existing deal, e.g. move it to another stage (deal_stage_id), change amount or expected close; only the fields you pass are changed. PUT /deals/{id}.","read_only":false},{"name":"freshsales_create_note","title":"Add note","description":"WRITE: add a note to a contact, account or deal. Visible to your team on the record. POST /notes.","read_only":false},{"name":"freshsales_update_note","title":"Update note","description":"WRITE: replace the text of an existing note. PUT /notes/{id}.","read_only":false},{"name":"freshsales_create_task","title":"Create task","description":"WRITE: create a task (to-do) attached to a contact, account or deal. title, due_date, owner_id and the target are required. POST /tasks.","read_only":false},{"name":"freshsales_update_task","title":"Update task","description":"WRITE: change a task: title, details, due date, owner, or mark it completed (status 1) or open (status 0). PUT /tasks/{id}.","read_only":false},{"name":"freshsales_create_appointment","title":"Create appointment","description":"WRITE: create an appointment (meeting) with a start and end, optionally attached to a contact, account or deal and with attendees. Attendees may be notified by Freshsales. POST /appointments.","read_only":false}],"server_info":{"name":"freshsales-mcp","version":"1.20.4","title":"Freshsales MCP by usefulapi","websiteUrl":"https://usefulapi.io/freshsales/","icons":[{"src":"https://usefulapi.io/icon.svg","mimeType":"image/svg+xml","sizes":["any"]},{"src":"https://usefulapi.io/icon-256.png","mimeType":"image/png","sizes":["256x256"]}]},"category":"productivity","tags":["sales","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-25","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-usefulapi-freshsales/"}