Skip to content

n8n-io/n8n-workflow-dev

v1.0.1Apache-2.0

Build, run, and debug n8n workflows inside Kiro against your own instance.

GitHubOpen Website

n8n Workflow Dev for Kiro

Build, run, and debug n8n workflows using the routes and types in your editor workspace. The power connects to your own n8n instance through its built-in MCP server. Workflows remain editable and runnable without Kiro.

Ready for submission: release 1.0.1 is available on main. The power's identifier is n8n-workflow-dev. On Kiro 1.2.37, the installed power passed public OAuth, native reads, draft creation, execution, wrong-output repair and runtime-error repair on released self-hosted n8n 2.43.7 and Cloud 2.43.5. Some calls omitted required pin data; guarded manual execution passed as a fallback. A separate HTTP-pinned simulation passed with the required arguments intact. Repository validation, a clean GitHub import, installed-helper setup and an authenticated native workflow read passed on the merged release. All acceptance gates are complete; the evidence and supported scope are recorded in the release checklist.

Requirements

  • Kiro IDE 1.1.70, 1.2.4 or 1.2.37 on macOS, in a local session; see the release checklist for live validation. The initial release supports macOS only. Newer Kiro versions are outside this release's supported range. Windows and Linux helper checks run in CI, but their IDE flows are not verified.
  • Node.js 22+, available to commands run by Kiro.
  • n8n 2.34.0+ for the workflow tool names. This is not a verified public-OAuth version floor; see the release checklist for tested server versions.
  • An owner/admin must enable Settings > Instance-level MCP. Workflow builder tools must also be enabled; self-hosted admins can disable them with N8N_MCP_BUILDER_ENABLED=false.
  • Existing workflows need Available in MCP enabled and appropriate user access for inspection, execution, or editing. Search previews may include workflows that have not been exposed.

Instance-level MCP is generally available: see the n8n 2.31 release notes and the GA change. The power uses the workflow management and builder tools, including workflows containing AI Agent nodes. Standalone n8n Agents are a separate Preview feature and are outside this release. GA status does not establish the oldest n8n release compatible with this power's OAuth setup.

Install and connect

  1. In Kiro > Powers > Add Custom Power > Import power from GitHub, enter https://github.com/n8n-io/n8n-kiro-power. Kiro reads the default branch; no checkout of a PR branch is required.
  2. Ask Kiro to connect to n8n and give it your instance base URL or full MCP URL. The connection skill runs the bundled helper. No npm install, token copying, or JSON editing is needed on this path.
  3. The helper creates a native user-level MCP connection shared across projects. Request workspace scope to configure only the current project.
  4. Under Kiro > MCP Servers, select the named server and Authenticate. Sign in to n8n and review consent. Kiro may request all advertised permissions: choose Custom, then workflow read/write/execute and execution read for basic workflow tasks. Use narrower grants for read-only tasks.
  5. Ask Kiro to search for a workflow. A successful read verifies the connection; a browser success page alone does not.

For manual setup from this checkout:

node skills/connect-n8n/scripts/setup.mjs configure --url "<your n8n URL>"

Replace the angle-bracket value. Use HTTPS except on loopback, and preserve any deployment base path. The default is a user-level connection shared across projects. For a project-only connection pass both flags, since --workspace alone still writes user settings:

node skills/connect-n8n/scripts/setup.mjs configure --url "<your n8n URL>" --scope workspace --workspace "<absolute project path>"

Settings live in Kiro's native configuration; this power ships no root mcp.json. See the setup guide for repair, removal, and migration.

Token fallback

If OAuth registration or callback policy prevents setup, you can explicitly choose an n8n MCP access token. Copy it from n8n's MCP connection settings into an environment variable available to Kiro, keeping the value out of chat and the repository. Add a separately named native MCP entry:

{
  "mcpServers": {
    "n8n-token": {
      "url": "https://YOUR-N8N-HOST/mcp-server/http",
      "headers": { "Authorization": "Bearer ${N8N_MCP_ACCESS_TOKEN}" }
    }
  }
}

Approve variable expansion in Kiro when prompted. A GUI-launched Kiro may not inherit terminal variables; restart it with the variable available after token rotation. The OAuth helper does not manage tokens or adopt this entry.

Using the power

  • connect-n8n checks the intended instance, connection, and access.
  • build-workflow uses workspace context to create and test workflows.
  • debug-execution investigates execution data and applies grounded repairs.

Workflow guidance comes from a pinned copy of n8n-io/skills, bundled with the power and reviewed local corrections. The three Kiro entry skills load the relevant shared guidance on demand; there is no second plugin to install. This repository owns OAuth setup and the Kiro adaptations. See shared-skill maintenance for updates.

The server supplies tool schemas and SDK instructions. Missing tools can reflect version, enabled features, licensing, OAuth permissions, or user access. Creating or editing a draft does not publish it. Real executions can affect external systems; simulated tests do not prove those integrations work.

Privacy and support

Workflow data goes between Kiro and your n8n instance. The helper makes discovery and public-client registration requests, then writes local configuration and nonsecret registration metadata. Kiro handles browser authorization and tokens. The helper adds no proxy, background service, telemetry, or token storage. Local configuration backups can contain secrets from other MCP entries; do not commit or share them.

Apache-2.0 license