Find workflows

Find workflows

Returns the n8n workflows you have access to, filtered by name, tags or project, with each one's ID and whether it is active.

Note: Over MCP, returns up to 200 previews, and an agent can run only the workflows whose availableInMCP is true.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "n8n": { "url": "https://{n8n_host}/mcp-server/http" } } }

Call the MCP tool search_workflows.

Server URL: https://{n8n_host}/mcp-server/http

Note: {n8n_host} is your instance's domain, such as acme.app.n8n.cloud. An owner or admin turns on Settings > Instance-level MCP first.

CLI (official)

Install the command, then confirm it runs.

npm install -g @n8n/cli
n8n-cli --version

Run n8n-cli workflow list.

Set $N8N_API_KEY in your environment first.

API (official)

• Base URL: https://{n8n_host}/api/v1
• Endpoint: GET /workflows
• Auth: send the header X-N8N-API-KEY: $N8N_API_KEY
• Docs: https://docs.n8n.io/connect/n8n-api

Note: {n8n_host} is your instance's domain, such as acme.app.n8n.cloud. The API is not available during the free trial.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.