Skip to content
MCP server

Insightly MCP by usefulapi

Read and write Insightly contacts, organisations, leads, opportunities, tasks and notes.

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Insightly MCP by usefulapi

Insightly MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http insightly https://insightly.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://insightly.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "insightly": {
      "url": "https://insightly.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "insightly": {
      "type": "http",
      "url": "https://insightly.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "insightly": {
      "serverUrl": "https://insightly.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "insightly": {
      "type": "http",
      "url": "https://insightly.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (21)

Read directly from the server.

insightly_get_current_user
Fetch the user the API key belongs to (USER_ID, name, email, admin flag). A cheap way to confirm the key and pod are right, and to get your own id for owner fields. Insightly: GET /Users/Me.
insightly_list_users
List the users in the Insightly instance — needed to resolve OWNER_USER_ID / RESPONSIBLE_USER_ID. Insightly: GET /Users.
insightly_list_records
List records of one type — Contacts, Organisations, Leads, Opportunities, Projects, Tasks, Events or Notes — optionally filtered by one field value and/or last-updated time. With field_name + field_value (both required together) or updated_after_utc this uses GET /<Object>/Search; otherwise GET /<Object>. Field names are Insightly's UPPER_SNAKE names, e.g. EMAIL_ADDRESS, LAST_NAME, ORGANISATION_NA
insightly_get_record
Fetch a single Contact, Organisation, Lead, Opportunity, Project, Task, Event or Note by id, with its custom fields, tags and links. Insightly: GET /<Object>/{id}.
insightly_list_record_activity
List the Notes, Tasks or Events attached to one Contact, Organisation, Lead, Opportunity or Project — the activity history of that record. Insightly: GET /<Object>/{id}/Notes | Tasks | Events.
insightly_search_by_tag
List Contacts, Organisations, Leads, Opportunities or Projects carrying a tag. Insightly: GET /<Object>/SearchByTag?tagName=.
insightly_list_pipelines
List the sales and project pipelines (PIPELINE_ID, name, whether for opportunities or projects). Insightly: GET /Pipelines.
insightly_list_pipeline_stages
List every pipeline stage (STAGE_ID, PIPELINE_ID, name, order) — map an opportunity's or project's STAGE_ID to a stage name. Insightly: GET /PipelineStages.
insightly_list_lead_statuses
List the lead statuses defined in the instance (LEAD_STATUS_ID, name, type). Insightly: GET /LeadStatuses.
insightly_list_lead_sources
List the lead sources defined in the instance (LEAD_SOURCE_ID, name). Insightly: GET /LeadSources.
insightly_create_contact
Create a contact (first_name is required). Insightly: POST /Contacts.
insightly_update_contact
Update a contact. Only the fields you pass are changed (v3.1 partial update). Insightly: PUT /Contacts with CONTACT_ID.
insightly_create_organisation
Create an organisation (company). Insightly: POST /Organisations.
insightly_update_organisation
Update an organisation. Only the fields you pass are changed. Insightly: PUT /Organisations with ORGANISATION_ID.
insightly_create_lead
Create a lead (last_name is required). Insightly's schema also marks lead_status_id and lead_source_id as required — get valid ids from insightly_list_lead_statuses / insightly_list_lead_sources. Insightly: POST /Leads.
insightly_update_lead
Update a lead. Only the fields you pass are changed. Insightly: PUT /Leads with LEAD_ID.
insightly_create_opportunity
Create a sales opportunity (opportunity_name is required). Insightly: POST /Opportunities.
insightly_update_opportunity
Update an opportunity's value, probability, dates, owner or details. Only the fields you pass are changed. Insightly: PUT /Opportunities with OPPORTUNITY_ID.
insightly_create_task
Create a task (title is required). Insightly requires OWNER_USER_ID and COMPLETED on a task: if owner_user_id is omitted it is filled with the API key's own user (via GET /Users/Me), and completed defaults to false. Insightly: POST /Tasks.
insightly_update_task
Update a task — mark it completed, change due date, status, assignee or details. Only the fields you pass are changed. Insightly: PUT /Tasks with TASK_ID.
insightly_add_note
Add a note (title + body) to a Contact, Organisation, Lead, Opportunity or Project. Insightly: POST /<Object>/{id}/Notes.

Insightly MCP by usefulapi FAQ

How do I add Insightly MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http insightly https://insightly.usefulapi.io/mcp