# Nango MCP connector

The Nango connector brings Nango's connections, connect sessions, and provider setups into Claude, ChatGPT, Cursor, and any MCP client, so your team can list, create, update, and delete them by asking, with every call logged.

Source: https://elaichi.ai/connectors/nango/

## Facts

| | |
| --- | --- |
| Application | Nango |
| Category | IPAAS |
| AI tools | 53 |
| Authentication | Connects with an API key |
| Needs your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 53 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Nango is connected

- List every Nango integration and how many connections each has.
- Which Nango connections were created in the last 14 days?
- Show connect sessions that never finished authorizing.

## Connect Nango in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Nango.
2. Optionally set Share with, then press Connect.
3. Paste a Nango API key. One person generates a token in Nango and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Nango tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Nango to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Nango to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Nango to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Nango to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Nango tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Nango through Elaichi

### Reconnect a customer whose connection stopped working

Support. When a customer reports that their linked account has gone stale, pull up their Nango connection, start a reconnect session, and send them the link without opening the Nango dashboard.

### Find every connection tied to one provider

Engineering. List all Nango connections for a given provider setup, check which ones are still healthy, and see at a glance how many customers depend on it before you change anything.

### Tag connections with account details

Customer success. Set metadata on a Nango connection so the account owner, plan tier, and region travel with it, then update those tags in bulk when a customer moves plans.

### Set up a newly supported provider

Product. Create the provider setup in Nango when your product starts supporting a new application, then review or adjust it by ID as the rollout progresses.

### Start a connect session for onboarding

Solutions. Create a Nango connect session for a new customer during implementation so they can link their account in one step, and check the session list to confirm they finished.

### Clean up stale sessions and churned accounts

Operations. Bulk delete abandoned Nango connect sessions and remove connections for customers who have left, keeping the workspace tidy and the connection count accurate.

## Frequently asked questions

### How do I connect Nango to Claude?

First connect Nango in Elaichi by pasting in a Nango API key, which is the only sign-in step Nango asks for. There is no OAuth application to register and no client ID or secret to generate. Then in Claude go to Customize, then Connectors, then Add, and paste the Elaichi endpoint https://api.elaichi.ai/mcp. Sign in as yourself and Nango is available in your next conversation.

### Does Nango work with ChatGPT and Cursor as well as Claude?

Yes. Once Nango is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client, and the Elaichi Agent. You connect Nango once and every client you use picks it up.

### What can an AI agent actually do with my Nango data?

An agent can list your Nango connections and provider setups, look up any one of them by ID, create new ones, update them, set or change the metadata attached to a connection, and delete what is no longer needed. It can also create connect sessions and reconnect sessions for your customers, list open sessions, and clear out old ones in bulk. Because Nango exposes many actions, short concrete asks such as "list connections for Salesforce" work better than long multi-part sentences.

### Does connecting Nango give the AI access to my whole Nango workspace?

The agent can only reach what the Nango API key you connected can reach, so access follows the person who signed in and the key they provided. Elaichi can narrow that further with per-action restrictions, but it can never grant anything the Nango key itself does not allow.

### Can my team share one Nango connection?

Yes. One person connects Nango in Elaichi and shares it with a team, and nobody else ever handles the Nango API key. Each teammate still signs in to Elaichi as themselves, so every action against Nango in the audit log is tied to the individual who asked for it, not to the person who connected it.

### Can I stop an agent from deleting or changing things in Nango?

Yes. Restrictions in Elaichi work per action, so you can allow listing and reading Nango connections while blocking deletes, bulk updates, or metadata changes. A blocked action is never advertised to Claude, ChatGPT, Cursor, or any other client, so no prompt, however worded, can reach it.

### What happens to a Nango connection when someone leaves?

Offboarding a person in Elaichi ends their access to Nango immediately, across every client they used. If the Nango connection was shared, it keeps working for everyone else on the team. If you disconnect Nango in Elaichi, it disappears from Claude, ChatGPT, Cursor, and every other client at once, with no per-client cleanup.

## All 53 Nango tools

Every tool below is callable through https://api.elaichi.ai/mcp once Nango is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Nango integrations** (List). List all integrations in Nango. Returns: created_at, updated_at, name.
- **Get single Nango integration by ID** (Get). Get a single Nango integration by its unique key. Returns: created_at, updated_at, data. Required: id. Use the include query parameter to retrieve webhook_url or credentials.
- **Create a Nango integration** (Create). Create a new integration in Nango. Returns: created_at, updated_at, data. Required: unique_key, provider.
- **Update a Nango integration by ID** (Update). Update an existing Nango integration by its unique key. Returns: created_at, updated_at, data. Required: id.
- **Delete a Nango integration by ID** (Delete). Delete a Nango integration by its unique key. Returns: data. Required: id.
- **Create a Nango connect session** (Create). Create a short-lived (30 minute) connect session in Nango for the Connect UI auth flow. Returns: token, connect_link, expires_at. Optional tags are copied onto the created connection and included in auth webhooks.
- **Nango connect sessions reconnect** (Action). Create a reconnect session in Nango to re-establish a connection with new credentials or manually refresh a token. Returns: token, connect_link, expires_at. Required: connection_id, integration_id. Only connections originally created with a connect session are compatible.
- **List all Nango connect session** (List). Retrieve a Nango connect session with its allowed integrations and default connection configurations. Returns: token, connect_link, expires_at.
- **Nango connect session bulk delete** (Delete). Delete a Nango connect session. Returns an empty 204 response on success.
- **Create a Nango connection** (Create). Create (upsert) a Nango connection for which you already have credentials. Returns the connection object including id, connection_id, provider, provider_config_key, created, credentials, metadata, tags, and errors. Required: provider_config_key, credentials.
- **List all Nango connections** (List). List Nango connections without credentials. Returns per connection: id, connection_id, provider, provider_config_key, created, metadata, tags, and errors.
- **Get single Nango connection by ID** (Get). Get a specific Nango connection with its credentials by id. Returns the full connection object including id, connection_id, provider, provider_config_key, created, credentials, metadata, tags, and errors. Required: id, provider_config_key.
- **Update a Nango connection by ID** (Update). Edit a Nango connection by id, updating its tags or webhook URL override. Returns: success. Required: id, provider_config_key.
- **Nango connections set metadata** (Set). Set (replace) custom metadata for one or more Nango connections. Pass an array of connection IDs to update multiple connections at once — if any ID is invalid the entire operation is aborted with no changes made. Returns: connection_id, provider_config_key, metadata, error. Required: connection_id, provider_config_key, metadata.
- **Delete a Nango connection by ID** (Delete). Delete a Nango connection by id. Returns: success. Required: id, provider_config_key.
- **Nango connections bulk update** (Update). Edit custom metadata for one or more Nango connections, overriding only the specified properties without replacing the entire metadata object. Pass a single connection ID string or an array of IDs to update multiple at once; if any ID in an array is invalid the entire operation is aborted with no changes made. Returns: connection_id, provider_config_key, metadata, error. Required: connection_id,…
- **List all Nango connection** (List). List nango connections (without credentials). Returns each connection's id, connection_id, provider, provider_config_key, created, metadata, tags, and errors. Optionally filter by connectionId for an exact match, search for a partial match, or tags to match all specified tag key-value pairs.
- **Get single Nango connection by ID** (Get). Get a specific nango connection with its credentials by id. Returns: id, connection_id, provider_config_key, provider, errors, end_user, metadata, connection_config, tags, created_at, updated_at, last_fetched_at, credentials, created, error. Required: id, provider_config_key.
- **Create a Nango connection** (Create). Add a nango connection for which you already have credentials using the deprecated `/connection` endpoint. Returns an empty 200 response on success. Required: provider_config_key. Supply credential fields appropriate to the auth type (OAuth2, OAuth1, Basic, API Key, etc.).
- **Nango connection set metadata** (Set). Set custom metadata on one or more nango connections using the deprecated `/connection/metadata` endpoint. Replaces the entire metadata object. Returns: connection_id, provider_config_key, metadata, error. Required: connection_id, provider_config_key, metadata. Pass an array of connection IDs in connection_id to update multiple connections at once.
- **Nango connection set metadata legacy** (Set). Set metadata on a single nango connection using the legacy path-based endpoint. The request body is a free-form metadata object whose keys and values replace the connection's metadata. Returns an empty 201 response on success. Required: connection_id.
- **Nango connection update metadata legacy** (Update). Update custom metadata for a specific Nango connection using the deprecated per-connection path endpoint. Only overrides specified properties without replacing the entire metadata object. Returns the updated metadata as user-defined key-value pairs. Required: connection_id. Deprecated — prefer the bulk_update method targeting /connection/metadata.
- **Delete a Nango connection by ID** (Delete). Delete a specific Nango connection by id (deprecated endpoint; use /connections/{connectionId} instead). Returns: success, error. Required: id, provider_config_key.
- **Nango connection bulk update** (Update). Update custom metadata for one or more Nango connections (deprecated endpoint; use /connections/metadata instead). Only overrides specified properties without replacing the entire metadata object. Returns: connection_id, provider_config_key, metadata, error. Required: connection_id, provider_config_key, metadata. If one connection_id in an array is invalid the entire operation is aborted.
- **List all Nango functions** (List). List functions deployed to a Nango integration, optionally filtered by type or name. Returns each function's id, name, type, enabled, last_deployed, and source. Required: unique_key.
- **Get single Nango function by ID** (Get). Get a single deployed function by id. Returns the function's id, name, type, description, enabled, last_deployed, and source. Required: unique_key, id.
- **Nango functions get code** (Get). Get the TypeScript source code of a deployed function. Returns: type, code, data. Required: unique_key, function_id.
- **Delete a Nango function by ID** (Delete). Delete a deployed Nango function and enqueue its async teardown. Returns: success, added, updated, deleted. Required: unique_key, id, type. Functions managed by nango deploy (repo source) cannot be deleted.
- **Nango functions compile** (Action). Compile TypeScript function source code into bundled JavaScript. Returns: added, updated, deleted. Required: code.
- **Nango functions create dryrun** (Create). Start an asynchronous dry run of TypeScript function source code against a Nango connection without deploying it. Returns: id, status, created_at, added, updated, deleted. Required: integration_id, function_type, code, connection_id.
- **Nango functions get dryrun** (Get). Get the status and result of an asynchronous function dry run in Nango. Returns: id, created_at, updated_at, data. Required: dryrun_id.
- **Nango functions create deployment** (Create). Deploy a function to an existing Nango integration using submitted TypeScript source code (type: function) or a provider template (type: template). Returns: id, status, created_at, added, updated, deleted. Required: type, integration_id, and either function_name, function_type, and code (for type: function) or template (for type: template).
- **Nango functions get deployment** (Get). Get the status and result of an asynchronous function deployment in Nango. Returns: id, created_at, updated_at, data. Required: deployment_id.
- **Nango scripts get config** (Get). Get configuration for all integration functions in Nango. Returns: data. Pass format=openai to receive the configuration in OpenAI function-calling format instead of the standard Nango format.
- **List all Nango records** (List). List synced records from Nango for a given data model, ordered by modification date ascending. Returns: id, _nango_metadata. Required: model. The filter parameter accepts added, updated, or deleted; a response may contain fewer records than the limit when records have a large size.
- **Nango records prune** (Action). Prune synced record payloads for a given connection and model using cursor-based pagination — empties the record payload while preserving metadata. Returns: count, has_more. Required: model, until_cursor. When has_more is true, make another request with the same until_cursor to continue pruning. The limit parameter (batch size) defaults to 1000 with a maximum of 10000.
- **Nango sync trigger** (Sync). Trigger a one-off execution of specified sync(s) in Nango for a given connection, or for all applicable connections if no connection is specified. Returns: success, added, updated, deleted. Required: provider_config_key, syncs.
- **Nango sync start** (Sync). Start the schedule of specified sync(s) in Nango for a given connection, or for all applicable connections if no connection is specified. The sync executes immediately upon starting and then continues at the configured frequency. If the schedule was already started, this has no effect. Returns: success, added, updated, deleted. Required: provider_config_key, syncs.
- **Nango sync pause** (Sync). Pause the schedule of specified sync(s) in Nango for a given connection, or for all applicable connections if no connection is specified. Returns: success, added, updated, deleted. Required: provider_config_key, syncs.
- **Nango sync get status** (Sync). Get the status of specified sync(s) in Nango for a given connection, or for all applicable connections if no connection is specified. Returns: id, connection_id, name, variant, status, type, finishedAt, nextScheduledSyncAt, frequency, latestResult, recordCount, checkpoint. Required: provider_config_key, syncs.
- **Nango sync bulk update** (Sync). Override a sync's default execution frequency for a specific connection in Nango, or revert to the default frequency by passing null for frequency. Returns: frequency, added, updated, deleted. Required: provider_config_key, connection_id, sync_name, frequency. Min frequency is 30 seconds.
- **List all Nango environment variables** (List). List environment variables configured in the Nango dashboard. Returns: name, value for each variable.
- **Create a Nango sync variant** (Create). Create a new sync variant for a specific connection in Nango. Returns: id, name, variant, added, updated, deleted. Required: name, variant, provider_config_key, connection_id. The variant name cannot be 'base' (protected).
- **Delete a Nango sync variant by ID** (Delete). Delete a sync variant for a specific connection in Nango. Returns: success, added, updated, deleted. Required: name, id, provider_config_key, connection_id.
- **Nango actions trigger** (Action). Trigger an action for a Nango connection. When triggered synchronously, returns the action's result data (max 10MB). When triggered asynchronously via the x_async header, Returns: id, statusUrl, your-properties. Required: action_name, connection_id, provider_config_key.
- **List all Nango proxy** (List). Forward a GET request to an external API through the Nango Proxy. Returns the external API's response body, headers, and status code exactly as received (opaque passthrough). Required: any_path.
- **Create a Nango proxy** (Create). Forward a POST request with a JSON body to an external API through the Nango Proxy. Returns the external API's response body, headers, and status code exactly as received (opaque passthrough). Required: any_path.
- **Nango proxy bulk update** (Update). Forward a PUT request with a JSON body to an external API through the Nango Proxy. Returns the external API's response body, headers, and status code exactly as received (opaque passthrough). Required: any_path.
- **Nango proxy bulk partial update** (Update). Forward a PATCH request with a JSON body to an external API through the Nango Proxy. Returns the external API's response body, headers, and status code exactly as received (opaque passthrough). Required: any_path.
- **Nango proxy bulk delete** (Delete). Forward a DELETE request to an external API through the Nango Proxy. Returns the external API's response body, headers, and status code exactly as received (opaque passthrough). Required: any_path.
- **List all Nango providers** (List). List all available Nango providers. Returns: name, display_name, auth_mode, logo_url, categories, proxy, authorization_url, authorization_url_encode, access_token_url, token_url_encode, token_url, authorization_params, scope_separator, default_scopes, token_params, authorization_url_replacements, authorization_url_fragment, redirect_uri_metadata, token_response_metadata, docs,…
- **Get single Nango provider by ID** (Get). Get a single Nango provider by id. Returns: name, display_name, auth_mode, logo_url, categories, proxy, authorization_url, authorization_url_encode, access_token_url, token_url_encode, token_url, authorization_params, scope_separator, default_scopes, token_params, authorization_url_replacements, authorization_url_fragment, redirect_uri_metadata, token_response_metadata, docs,…
- **Nango providers list templates** (List). List template functions available in the Nango catalog for a provider. Returns: name, type, description, scopes, input, returns, json_schema, runs, auto_start, track_deletes. Each item is a sync or action template function with its input/output schema and schedule. Required: provider.