Integrations

This page covers everything SyntrofAI connects to outside itself, and how to connect each one. Model providers such as OpenAI, Anthropic or Google have their own page: Models and providers.

Most connections live in Settings → External. Social credentials live in Social → Settings, and MCP and A2A in Settings → MCP/A2A.

Talk to Nova outside the app

Messaging connectors are under Settings → External → Messaging Connectors. Once enabled, they keep running when your browser is closed. Press Refresh Status in the Connector Status panel to see whether each one is live.

WhatsApp

WhatsApp is linked as a device on that account, the same way WhatsApp Web is. It does not use the WhatsApp Business API. Goal check-ins and workflow results can reach you there.

Telegram

Gmail

Emails from trusted senders become Nova conversations, and Nova replies through Gmail. You can connect several inboxes. Each card shows a status: Live, Ready, Paused, Needs app password or Polling error. Email works with Gmail only, through an App Password.

In the app

Notifications and workflow results can also stay in the app. They appear in the notification inbox under the bell.

Social research and feed sources

The same credentials serve two purposes. They let Nova's research tools read these platforms, and they let the Social feed collect posts from them. Add them in Social → Settings → Platform Credentials. The same fields are also in Settings → Social. Everything here is read-only: SyntrofAI collects and reads posts, it does not post for you.

Bluesky, Mastodon, Threads, Substack and LinkedIn are watched through public web search, so they need no account. Results are best effort.

These open sources need no key at all. Add them as feed sources in Social → Settings.

Data steps in workflows

Workflows connect to 105 platforms: CRMs, spreadsheets, databases, payments, project tools, cloud services, social networks and more. Add a platform as a step from the Platforms panel in the Workflow editor. A platform step needs that platform's key on your instance; until it is there, the panel marks the step not connected.

Research databases

Nova's Knowledge Databases tool searches ten public registries in one go, with no keys: PubMed, arXiv, bioRxiv, medRxiv, ChEMBL, ClinicalTrials.gov, Open Targets, DailyMed, the NPI Registry and SEC filings.

MCP and A2A

Use tools from MCP servers

An example configuration:

{
  "mcpServers": {
    "files": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data/shared"]
    },
    "remote-tools": {
      "url": "https://mcp.example.com/sse",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

The editor's Examples button shows more, and Reformat tidies the JSON. MCP Client Init Timeout and MCP Client Tool Timeout set how long SyntrofAI waits for a server to start (default 60 seconds) and for a tool call (default 120 seconds). Once connected, the server's tools are available to Nova like built-in ones.

Let other systems use Nova

• SyntrofAI MCP Server: turn on Enable SyntrofAI MCP Server and press Save. The connection example link shows the addresses to give an MCP client.
• SyntrofAI A2A Server: turn on Enable A2A server so other agents can call Nova. The connection example shows the address.
• Agent to Agent: going the other way, Nova's Agent to Agent tool can talk to an outside agent that speaks A2A, given its address.

External API and webhooks

• External API: SyntrofAI has API endpoints authenticated with an X-API-KEY header. You can send messages and files, and work with chats, agents, memory, teams and tasks. Open Settings → External → External API → Show API Examples for the full reference with examples.
• Workflow webhooks: give a workflow a Signed event trigger and publish it. Another system can then start it with signed requests. Create, rotate and revoke the signing key from the key button in the workflow editor.

Coding CLIs

Nova's Coding Agent tool can hand a coding job to a coding command-line tool installed and signed in on your instance: Codex, Claude Code, Gemini CLI, Cursor, Grok or OpenCode. Edits ask for your approval first. Ask your administrator which ones are set up.

Related