Skip to main content
n8n supports three useful BeeOS patterns. They are complementary rather than interchangeable.

​
BeeOS community nodes

The standalone n8n-nodes-beeos package provides:
  • one BeeOS action node for instance and Agent discovery, durable tasks, instance lifecycle, file resolution, computer use, and mobile control;
  • a polling trigger for newly created or closed BeeOS tasks;
  • an encrypted BeeOS API credential with a connection test.
n8n-nodes-beeos 0.1.0 is in release preparation and is not yet available from npm or the n8n Community Nodes catalog. The installation flow below becomes valid after the first release.
On a self-hosted n8n instance, open Settings → Community Nodes, install n8n-nodes-beeos, and create a BeeOS API credential using https://openapi.beeos.ai and a BeeOS user API key. The action node can be used in a deterministic workflow or attached to an n8n AI Agent as a tool. Instance destruction has a dedicated confirmation field. For purchases, outbound messages, account changes, and other external side effects, keep an explicit human-approval step in the workflow. Do not automatically retry a timed-out computer or mobile action: it may already have executed.

​
MCP Client Tool

  1. Add an AI Agent node.
  2. Attach an MCP Client Tool node.
  3. Set the Streamable HTTP URL to https://mcp.beeos.ai/<agentId>/mcp.
  4. Configure Authorization: Bearer <oag_key> in n8n credentials, not directly in the workflow JSON.
  5. Let the node discover tools and test a low-risk request.
Use MCP when the surrounding model should choose the tool. It is not a durable queue: if the workflow must survive a long disconnect, use OpenAPI tasks.

​
Durable OpenAPI workflow

A production workflow usually has these nodes:
Configure one n8n HTTP Header Auth credential:
Use https://openapi.beeos.ai as the base URL. Generate an idempotency key from the n8n execution ID so retries do not create duplicate device actions. Put a hard limit on polling and call the task cancel endpoint when the workflow is stopped.
For high-volume workflows, prefer a BeeOS task webhook over a tight polling loop. Verify the webhook signature before resuming the workflow.
For an approval-based mobile operation, let n8n collect and validate input, pause for human approval, then create one BeeOS task through OpenAPI. Reserve the MCP pattern for conversational automation where an AI Agent is deliberately allowed to choose the phone operation. See Calling Agents, Task Lifecycle, and Webhooks.