n8n Management MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:76-78 (handler)

  The actual handler method that executes the delete workflow logic. Makes an authenticated DELETE request to the n8n API endpoint /api/v1/workflows/{id}

  async deleteWorkflow(id: string) {
    return this.request(`${this.apiBase}/workflows/${id}`, { method: 'DELETE' });
  }

• src/tools.ts:85-101 (schema)

  Tool schema definition including name, description, input schema (requires 'id' parameter), and annotations marking it as destructive and idempotent

    name: 'n8n_delete_workflow',
    description: 'Permanently delete a workflow and all associated execution history. This action cannot be undone. Workflow must be deactivated first. Use with caution.',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Workflow ID to permanently delete' },
      },
      required: ['id'],
    },
    annotations: {
      title: 'Delete Workflow',
      readOnlyHint: false,
      destructiveHint: true,
      idempotentHint: true,
      openWorldHint: true,
    },
  },

• src/server.ts:33-34 (registration)

  Registration point where the tool name 'n8n_delete_workflow' is mapped to the client.deleteWorkflow handler method

  case 'n8n_delete_workflow':
    return client.deleteWorkflow(args.id);