README

Integrations for AI agents

Connect your AI agents to 1,000+ APIs with 10,000+ pre-built tools and Nango managed OAuth apps.

nango.dev · 1,000+ APIs · Docs · Slack community







 Nango

Nango is an open-source platform for building agent integrations. It provides 10,000+ prebuilt tools across 1,000+ APIs, with managed authentication and execution for tool calls, triggers, syncs, webhooks, and API proxy requests. Customize tools in TypeScript and sync external data into your app when your use case needs more.

Used in production by ServiceNow, Replit, Ramp, Mercor, and hundreds more.

 How it works

Nango gives you three primitives that cover every integration pattern:

 1. Auth

Managed OAuth, API keys, and token refresh for 1,000+ APIs. Embed a white-label auth flow in your app. Nango handles credentials, token storage, and multi-tenant connection management.

typescript
// Embed auth in your frontend
nango.openConnectUI({ onEvent: (event) = { / handle completion / } });


 2. Proxy

Make authenticated API requests on behalf of your users. Send requests through Nango's proxy: it resolves the provider, injects credentials, handles retries and rate limits, and returns the response.

typescript
import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '' });

// Make an authenticated request to any API
const response = await nango.get({
    endpoint: '/v3/contacts',
    providerConfigKey: '',
    connectionId: ''
});


 3. Functions

Write integration logic as TypeScript functions and deploy to Nango. Functions execute on a production runtime with built-in API access, retries, storage, and observability.

Use the AI builder to generate them from a description of your use case.

typescript
export default async function run(nango: Nango) {
    const { owner, repo, title, body } = nango.input;
    
    const response = await nango.post({
        endpoint: /repos/${owner}/${repo}/issues,
        data: { title, body }
    });
    
    return response.data;
}


 What you can build

Nango supports every common integration pattern:

| Use case | Description |
| --- | --- |
| AI tool calling & MCP | Give AI agents the ability to act on external APIs |
| Data syncing | One or two-way sync for RAG pipelines, indexing, and triggers |
| Webhook processing | Receive and process webhooks from external APIs reliably |
| API unification | Normalize APIs to your own universal schema |
| Actions | Write data and execute operations on behalf of your users |
| Per-customer config | Customize integration behavior for each customer |

 Quickstart

Get up and running in under 5 minutes:

1. Create an integration. Sign up (free, no credit card), then configure a new integration in the Integrations tab.

2. Authorize the API. On the Connections tab, create a connection and complete the auth flow. Later, embed this in your product:

typescript
nango.openConnectUI({ onEvent: (event) = { / handle completion / } });


3. Access the API. Retrieve credentia