n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:1661-1691 (handler)

  MCP tool handler for 'delete-execution' that retrieves the N8nClient instance and calls its deleteExecution method, handling errors and success responses.

  case "delete-execution": {
    const { clientId, id } = args as { clientId: string; id: number };
    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.deleteExecution(id);
      return {
        content: [{
          type: "text",
          text: `Successfully deleted execution:\n${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:292-296 (helper)

  Core implementation in N8nClient class that performs the HTTP DELETE request to the n8n API endpoint /executions/{id}.

  async deleteExecution(id: number): Promise<N8nExecution> {
    return this.makeRequest<N8nExecution>(`/executions/${id}`, {
      method: 'DELETE',
    });
  }

• src/index.ts:722-732 (registration)

  Tool registration in the ListTools response, including name, description, and input schema.

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

• src/index.ts:724-731 (schema)

  Input schema definition for the delete-execution tool, specifying clientId (string) and id (number) as required parameters.

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