Nango
Nango provides a unified API to integrate with over 250 external APIs, offering pre-built and customizable integrations for various categories such as CRM, HR, and accounting systems.
Verdict
Common use cases
- Debug OAuth connection state during incident response
- Trigger manual data syncs before quarterly reviews
- Inspect provider configs when onboarding new integrations
- Run workflow actions from standup chat
- Audit connection metadata across environments
Integration
- Vendor
- Nango
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 7
- Composio slug
nango
Tools
- Get Provider Details
Tool to retrieve details for a specific provider. use when you need to fetch provider configuration details by name (e.g., 'salesforce'). use after selecting the provider.
- Get Scripts Configuration
Tool to fetch the nango scripts configuration. use when you need to get the available scripts and their triggers.
- List Connections
Tool to list all connections. use when you need to retrieve existing connections.
- List Connections
Tool to list all connections without credentials. use when you need connection metadata across your account without exposing credentials.
- List Providers
Tool to retrieve a list of all available providers. use when you need to display or iterate through every provider before creating connections.
- Trigger Nango Action
Tool to trigger nango workflow actions via api. use when you need to execute an action by specifying the connection, provider config, and action identifier.
- Trigger Sync
Tool to trigger a sync process manually. use after establishing a connection and defining a sync.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add MCP Integration' and select Nango from the developer tools category. 3. Paste your Nango API key — generate one in your Nango dashboard under API Keys with both read and write permissions. 4. Click 'Connect' and wait for Switchy to verify the key against Nango's API. 5. Once connected, open any Project and type '@Nango list connections' to confirm the integration works. 6. You'll see a list of your active connections returned inline; if the list is empty, verify you have at least one connection configured in Nango. 7. To invoke other tools, @mention Nango followed by a command like 'trigger sync for connection_id' or 'get provider details for salesforce'.
What teammates see: by default, memories from Nango are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List All Connections
@Nango list all connections in my account and show me the provider name, connection ID, and creation date for each one.
Trigger Salesforce Sync
@Nango trigger a sync for my Salesforce connection with ID conn_abc123 and let me know when it completes.
Get Provider Config
@Nango get the provider details for hubspot and tell me which OAuth scopes are currently enabled.
Run Workflow Action
@Nango trigger the 'enrich_contact' action for my Intercom connection using provider config intercom_prod.
Check Scripts Config
@Nango fetch the scripts configuration and list all available sync triggers and their associated providers.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@nango list all active connections and show me which APIs they're connected to
Here are your active Nango connections: 1. **salesforce-prod** (Salesforce) - Connected 3 days ago, last synced 2 hours ago 2. **hubspot-marketing** (HubSpot) - Connected 12 days ago, last synced 45 minutes ago 3. **github-repos** (GitHub) - Connected 8 days ago, last synced 1 hour ago All connections are healthy with no authentication errors. The Salesforce and HubSpot connections have active syncs running on schedule.
This read-only query shows connection metadata without exposing credentials. Useful for auditing which third-party APIs your team has integrated. Requires a valid Nango API key with read permissions. The actual connection list depends on what your team has configured in Nango.
@nango trigger the contact sync action for our hubspot-marketing connection to pull latest contacts
Sync triggered successfully for **hubspot-marketing** connection. **Action:** contact-sync **Provider:** HubSpot **Status:** Running **Sync ID:** sync_8x9k2m4p The sync will fetch contacts updated in the last 24 hours and make them available via your Nango unified API. Estimated completion: 2-3 minutes depending on contact volume.
This demonstrates Nango's core workflow execution capability. The action name ('contact-sync') must match a script defined in your Nango configuration. This is a write operation that initiates data movement from HubSpot into Nango's cache. Check your Nango rate limits if syncing large datasets frequently.
@nango get the available providers and tell me which ones support OAuth 2.0 authentication
Nango supports 150+ providers. Here are OAuth 2.0-enabled providers relevant to common workflows: **CRM:** Salesforce, HubSpot, Pipedrive, Zoho CRM **Project Management:** Asana, Linear, Monday.com, Jira **Communication:** Slack, Microsoft Teams, Discord **Accounting:** QuickBooks, Xero, FreshBooks **Storage:** Google Drive, Dropbox, Box All listed providers use OAuth 2.0 for secure authorization. Each requires registering your app with the provider to obtain client credentials before creating a Nango connection.
This synthesis example combines Nango's provider catalog with the AI's filtering logic. The actual provider list is comprehensive but static — Nango adds new integrations periodically. Useful for scoping integration projects before writing code. The OAuth 2.0 requirement means you'll need to handle redirect flows in your application.
Use-case deep-dives
When Nango wins for customer-context aggregation at 10-person scale
A 10-person support team pulls customer data from Salesforce, Stripe, and Zendesk into a shared Switchy workspace every morning. Nango's the right call here because you're orchestrating three OAuth providers with different refresh cycles, and the Trigger Sync tool lets you fire manual updates when a high-value ticket lands. The List Connections tool surfaces which integrations are stale without exposing API keys to the whole team. The threshold: if you're only syncing one provider or your data updates less than twice a week, Nango's overhead (managing provider configs, action triggers) outweighs a simpler direct-API setup. But for multi-source customer context that changes daily, Nango keeps your team from writing refresh logic for each SaaS vendor. Set it up once, trigger syncs from Switchy when context matters.
When Nango handles cross-platform automation for deal stages
A 6-person sales ops team moves deals through HubSpot, Slack notifications, and contract generation in DocuSign. Nango's Trigger Action tool fires workflows when a deal hits "Closed Won"—updating Slack, kicking off DocuSign templates, logging revenue in a spreadsheet. This scenario works because you're chaining actions across providers that each need OAuth, and Nango's scripts configuration centralizes the logic instead of scattering it across Zapier and custom code. The trade-off: if your workflows are simple two-step automations ("HubSpot to Slack"), you don't need Nango's action orchestration—a webhook does it. But when you're triggering 3+ steps across providers with conditional logic, Nango keeps the chain auditable and the credentials secure. Wire it into Switchy so the ops lead can see which workflows ran overnight without touching the Nango dashboard.
When Nango speeds up new-hire integration discovery
A 4-person dev team onboards a junior engineer who needs to understand which third-party APIs the product already connects to. The List Providers and Get Provider Details tools let them query Nango from Switchy and see every configured integration (Stripe, Twilio, Google Calendar) with auth scopes and rate limits in one place. This beats hunting through .env files or Notion docs. The boundary: if your product only integrates 2-3 APIs and they're all documented in your README, Nango's overkill. But once you're managing 5+ OAuth providers with rotating credentials and different refresh behaviors, Nango becomes the source of truth. The junior dev asks Switchy "what Salesforce scopes do we use" and gets the answer in 10 seconds instead of pinging three teammates. Set up read-only access so they can explore without breaking connections.
Frequently asked
What does the Nango MCP do in Switchy?
It lets Switchy read and trigger your Nango integration workflows without leaving the chat. You can list connections, fetch provider configs, run syncs, and fire actions — so your AI agents can orchestrate data pipelines across the 300+ APIs Nango supports. Think of it as giving your team's AI direct access to your Nango account's orchestration layer.
Do I need a Nango API key to connect this MCP?
Yes. You'll paste your Nango secret key during setup in Switchy. Generate it from your Nango dashboard under Settings → API Keys. The key gives read and write access to connections, syncs, and actions, so treat it like a production credential. Only workspace admins should configure this MCP.
Can the Nango MCP create new OAuth connections to third-party apps?
No. It can list and inspect existing connections, but it can't initiate the OAuth dance to authorize a new Salesforce or Slack account. You still create connections through Nango's UI or frontend SDK. Once they exist, this MCP can trigger syncs and actions against them.
Why use this MCP instead of calling Nango's API directly in code?
Because your team can now ask "Run the Salesforce contact sync" in plain English, and Switchy handles the API call, error parsing, and response formatting. No one writes curl commands or digs through docs. It's faster for ad-hoc ops work and lets non-engineers trigger workflows safely.
Who on my team should connect the Nango MCP?
Whoever manages your integration infrastructure — typically a backend engineer or DevOps lead. They'll need access to your Nango secret key and should understand which syncs and actions are safe to expose. Once connected, any Switchy workspace member can invoke the tools, so set workspace permissions accordingly.