MCP- N8N

Instructions

Implementation Reference

• src/index.ts:887-926 (handler)

  The primary handler for executing the 'list-workflows' tool. It retrieves the N8nClient instance using the provided clientId, calls the client's listWorkflows method, formats the workflow data, and returns it as a JSON string in the tool response.

  case "list-workflows": {
    const { clientId } = args as { clientId: string };
    const client = clients.get(clientId);
    if (!client) {
      return {
        content: [{
          type: "text",
          text: "Client not initialized. Please run init-n8n first.",
        }],
        isError: true
      };
    }
  
    try {
      const workflows = await client.listWorkflows();
      const formattedWorkflows = workflows.data.map(wf => ({
        id: wf.id,
        name: wf.name,
        active: wf.active,
        created: wf.createdAt,
        updated: wf.updatedAt,
        tags: wf.tags,
      }));
  
      return {
        content: [{
          type: "text",
          text: JSON.stringify(formattedWorkflows, null, 2),
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:413-422 (registration)

  Registration of the 'list-workflows' tool within the ListToolsRequestSchema handler. Defines the tool's name, description, and input schema, making it discoverable by MCP clients.

    name: "list-workflows",
    description: "List all workflows from n8n. Use after init-n8n to see available workflows. IMPORTANT: Arguments must be provided as compact, single-line JSON without whitespace or newlines.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" }
      },
      required: ["clientId"]
    }
  },

• src/index.ts:415-421 (schema)

  Input schema for the 'list-workflows' tool, specifying that a 'clientId' string is required.

  inputSchema: {
    type: "object",
    properties: {
      clientId: { type: "string" }
    },
    required: ["clientId"]
  }

• src/index.ts:156-158 (helper)

  Core helper method in the N8nClient class that makes the HTTP request to the n8n API endpoint '/workflows' to retrieve the list of workflows.

  async listWorkflows(): Promise<N8nWorkflowList> {
    return this.makeRequest<N8nWorkflowList>('/workflows');
  }

• src/index.ts:33-36 (schema)

  TypeScript interface defining the structure of the response from the n8n workflows list API, used by the listWorkflows method.

  interface N8nWorkflowList {
    data: N8nWorkflow[];
    nextCursor?: string;
  }