n8n Management MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:215-217 (handler)

  The deleteUser method that implements the tool logic - makes a DELETE request to the n8n API endpoint /users/{id}

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

• src/tools.ts:470-486 (schema)

  Tool definition with input schema requiring an 'id' parameter (string) and annotations indicating it's a destructive operation

    name: 'n8n_delete_user',
    description: 'Remove user from n8n instance. Only available to instance owner. Cannot delete the owner account. Deleted users lose access immediately. Workflows created by this user remain intact.',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'User ID to permanently delete (not email)' },
      },
      required: ['id'],
    },
    annotations: {
      title: 'Delete User',
      readOnlyHint: false,
      destructiveHint: true,
      idempotentHint: true,
      openWorldHint: true,
    },
  },

• src/server.ts:83-84 (registration)

  Routes the 'n8n_delete_user' tool call to the client.deleteUser method with the id argument

  case 'n8n_delete_user':
    return client.deleteUser(args.id);