n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:1629-1659 (handler)

  Handler for the 'get-execution' tool. Retrieves the N8nClient instance using clientId, calls getExecution on it with the provided id and optional includeData, and returns the execution data as JSON or an error.

  case "get-execution": {
    const { clientId, id, includeData } = args as { clientId: string; id: number; includeData?: boolean };
    const client = clients.get(clientId);
    if (!client) {
      return {
        content: [{
          type: "text",
          text: "Client not initialized. Please run init-n8n first.",
        }],
        isError: true
      };
    }
  
    try {
      const execution = await client.getExecution(id, includeData);
      return {
        content: [{
          type: "text",
          text: JSON.stringify(execution, null, 2),
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:708-720 (schema)

  Input schema and registration of the 'get-execution' tool in the listTools response, defining parameters: clientId (string, required), id (number, required), includeData (boolean, optional).

  {
    name: "get-execution",
    description: "Retrieve a specific execution by ID.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" },
        id: { type: "number" },
        includeData: { type: "boolean" }
      },
      required: ["clientId", "id"]
    }
  },

• src/index.ts:285-290 (helper)

  N8nClient method that implements the core logic: makes an API request to `/executions/${id}` with optional includeData parameter to fetch the execution details from n8n.

  async getExecution(id: number, includeData: boolean = false): Promise<N8nExecution> {
    const params = new URLSearchParams();
    if (includeData) params.append('includeData', 'true');
  
    return this.makeRequest<N8nExecution>(`/executions/${id}?${params.toString()}`);
  }

• src/index.ts:61-72 (helper)

  TypeScript interface defining the structure of an N8nExecution object returned by the getExecution method.

  interface N8nExecution {
    id: number;
    data?: any;
    finished: boolean;
    mode: string;
    retryOf?: number;
    retrySuccessId?: number;
    startedAt: string;
    stoppedAt?: string;
    workflowId: number;
    waitTill?: string;
  }