nango README

The project's README from github.com/NangoHQ/nango. As one markdown file: README.md.

Build product integrations with AI.

Connect your product & AI agents with 900+ APIs. Build, run, and maintain integrations with AI in code, on infrastructure built for scale.

Website · Docs · 900+ APIs · Slack Community

GitHub Stars License NPM Downloads

What is Nango?

Nango is an open-source platform for building product integrations. It supports 900+ APIs and works with any backend language, AI coding tool, and agent SDK.

You write integration logic as TypeScript functions, or let AI generate them for you, and deploy to Nango's production runtime. Nango handles auth, execution, scaling, and observability.

Used in production by 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 900+ APIs. Embed a white-label auth flow in your app. Nango handles credentials, token storage, and multi-tenant connection management.

// 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.

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

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

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

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.

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:

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

3. Access the API. Retrieve credentials and make authenticated requests:

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

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const connection = await nango.getConnection('<INTEGRATION-ID>', '<CONNECTION-ID>');
console.log(connection.credentials);

Embed the Auth flow in your product, make requests with the Proxy, or build custom integrations with Functions.

Why Nango?

AI-generated, human-controlled code. Nango's AI builder generates TypeScript integration functions from natural language. Unlike black-box solutions, you get readable code you can review, edit, and version control. With full type safety and a built-in testing framework.

Production-grade infrastructure. Nango processes billions of API requests. The runtime provides per-tenant isolation, elastic scaling, automatic retries, and rate-limit handling. Battle-tested by hundreds of companies in production.

Auth for 900+ APIs, out of the box. OAuth flows, token refresh, credential storage, and multi-tenant support handled for you. Connect to any API without building auth from scratch.

Open source and self-hostable. Nango is fully open source. Run it on Nango Cloud or self-host on your own infrastructure. SOC 2 Type II, HIPAA, and GDPR compliant.

Fits your workflow. Fully operable via CLI and API. Compatible with any backend language or framework, AI coding tools (Cursor, Codex, Claude Code), and agent SDKs (MCP, LangChain).

Open-source vs. paid

Nango is available under the Elastic License. The Cloud and Enterprise Self-Hosted versions give you access to all features, based on your plan. You can also self-host for free with a limited feature set.

Contributing

We welcome contributions — anyone can add support for a new API.

Thank you to all contributors ❤️

nango (NangoHQ/nango)

oauth
Searching Database…

12.8K ·GitHub
Nango
What is this?Nango is an open-source platform for building product integrations that connects your product and AI agents to over 900 APIs, handling auth, execution, scaling, and observability for you.
Is this a hosted service or something I self-host?Both: you can use Nango Cloud as a managed service or self-host it on your own infrastructure, since the whole platform is open source.
Which coding agents and languages does it work with?Nango works with any backend language or framework, AI coding tools like Cursor, Codex, and Claude Code, and agent SDKs like MCP and LangChain.
What do I lose if I self-host for free instead of paying?The free self-hosted version ships with a limited feature set; full capabilities require the Cloud or Enterprise Self-Hosted plans.
What is the AI builder?It generates TypeScript integration functions from a natural-language description of your use case, giving you readable, editable, version-controlled code instead of a black box.
What are the three core building blocks?Auth manages OAuth and API keys for 900+ APIs, Proxy makes authenticated requests on behalf of users, and Functions let you write and deploy custom integration logic as TypeScript code.
Is Nango used in production at scale?Yes, it's used in production by companies like Replit, Ramp, and Mercor, and the runtime processes billions of API requests with per-tenant isolation and elastic scaling.
Is it suitable for handling sensitive customer data?Nango states it is SOC 2 Type II, HIPAA, and GDPR compliant, which supports use with regulated or sensitive data.
What are similar projects?corsair, open-connector, trueforge, n8n, anythingmcp, logto, LibreChat, useagent
Which topics is it in?integrations, api-client, oauth2, oauth, rest-api, cloud, mcp, api, automation, ai-agents, server, nodejs
Creator
NangoHQ
Size
372.5 MB
Stars
12.8K
Updated
CommitOct 16Releasev0.71.13Oct 14
Age
6y
Commits · 90 Days