# Onedesk — how to use (mcp.ai)

Connect your Onedesk account and use 24 tools for customer support straight from your AI agent. Connect with your own API key. OneDesk is an all-in-one platform combining help desk and project management functionalities, enabling teams to manage customer support and project tasks seamlessly.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_onedesk?ms=1787296080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `onedesk_create_worklog`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/onedesk`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/onedesk/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/onedesk/create/worklog` — Create a worklog entry to track time spent on a work item (task, ticket, project, etc.). Records the start and finish time, work hours, completion percentage, and billability. Use this after obtaining
  - body: { works?: number, item_id: integer, billable?: boolean, comments?: string, date_start: string, percentage?: number, date_finish: string, lifecycle_status_id?: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/attachment` — Delete a specific attachment from OneDesk by its ID. To use this tool, provide the attachment_id. Note that the OneDesk Public API has limited attachment management capabilities. Attachments are typic
  - body: { attachment_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/comment` — Deletes a comment from OneDesk by its ID. Use this tool to permanently remove a comment when it's no longer needed. Note: OneDesk's Public API has limited DELETE support for comments. This action trie
  - body: { comment_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/customer` — Deletes a customer from OneDesk using the DELETE /customers/{id} endpoint. This action permanently removes the customer record from the OneDesk account. Returns: - success=true: Customer was successfu
  - body: { customer_id: string }
- `POST https://api.mcp.ai/api/onedesk/delete/message` — Deletes a message from OneDesk by its unique message ID. Returns success if the message is deleted or doesn't exist (idempotent operation). Use this when you need to permanently remove a message from 
  - body: { message_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/project` — Delete a project in OneDesk by its ID. **API LIMITATION**: The OneDesk Public API does not support DELETE operations. DELETE requests return 405 Method Not Allowed on /rest/public/items endpoints. The
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/requirement` — Delete a requirement from OneDesk. Requirements in OneDesk are work items used for product development, feature requests, and specifications. They are one of the core work item types (tickets, tasks, 
  - body: { requirement_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/task` — Tool to delete a specific task. Use when you need to remove an existing task by its ID after confirming its details.
  - body: { task_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/ticket` — Deletes a ticket from OneDesk by its internal ID. Use this tool to permanently remove a ticket when it's no longer needed. The ticket will be moved to the 'Deleted Items' project and scheduled for per
  - body: { ticket_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/timesheet` — Tool to delete a timesheet by its ID. Use when you need to remove a specific timesheet after confirming it's no longer needed. Example: {'timesheet_id': 123}
  - body: { timesheet_id: integer }
- `POST https://api.mcp.ai/api/onedesk/delete/user` — Deletes a user from OneDesk by their unique user ID. This action permanently removes the specified user from the OneDesk account. Use this only after confirming the user should be removed from the sys
  - body: { user_id: string }
- `POST https://api.mcp.ai/api/onedesk/get/attachments` — Retrieve attachments for a specific item by its external ID. IMPORTANT: The OneDesk Public API (/rest/public) has limited functionality and does NOT provide: - A dedicated attachments list endpoint - 
  - body: { external_id: string }
- `POST https://api.mcp.ai/api/onedesk/get/comment/details` — Retrieve detailed information for a specific comment by its ID. This action attempts to fetch comment details from OneDesk using the comment ID. It tries multiple endpoint patterns to maximize compati
  - body: { comment_id: integer }
- `POST https://api.mcp.ai/api/onedesk/get/comments` — Attempts to retrieve comments (discussion posts) from OneDesk. **IMPORTANT LIMITATION**: The OneDesk Public REST API does not provide an endpoint to list or retrieve comments. According to OneDesk's A
  - body: { item_id?: integer }
- `POST https://api.mcp.ai/api/onedesk/get/feedback` — Retrieve all feedback items from OneDesk. **IMPORTANT LIMITATION**: The OneDesk Public API does not provide a GET endpoint to list feedback items. The public API only supports: - Creating items via PO
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/onedesk/get/feedback/details` — Retrieve detailed information about a specific item in OneDesk by its internal ID. This endpoint retrieves ANY type of item (Tickets, Tasks, Feedback, etc.), not just feedback items. Use this action w
  - body: { feedback_id: integer }
- `POST https://api.mcp.ai/api/onedesk/get/issue/details` — Retrieve comprehensive details of a specific issue by its ID. This action fetches full information about an issue including its title, description, status, priority, creation/update timestamps, and ot
  - body: { issue_id: integer }
- `POST https://api.mcp.ai/api/onedesk/get/issues` — Retrieve a list of issues from OneDesk. **API LIMITATION**: The OneDesk Public API does not provide an endpoint to list or retrieve issues. The public API only supports: 1. Creating items via POST /re
- `POST https://api.mcp.ai/api/onedesk/get/messages` — Tool to retrieve a list of messages from OneDesk. **IMPORTANT LIMITATION**: The OneDesk Public API does not provide an endpoint to list or retrieve messages. The public API only supports: 1. Creating 
  - body: { limit?: integer, offset?: integer, search?: string, direction?: string, ticket_id?: integer, contact_id?: integer }
- `POST https://api.mcp.ai/api/onedesk/get/requirements` — Retrieve a list of requirements from OneDesk. **IMPORTANT LIMITATION**: This action cannot function as intended because the OneDesk Public API does not provide an endpoint to list or retrieve requirem
- `POST https://api.mcp.ai/api/onedesk/get/task/details` — Retrieves comprehensive details of a specific task/item in OneDesk by its ID. Use this tool when you need complete information about a task including its title, description, status, assignee, priority
  - body: { task_id: integer }
- `POST https://api.mcp.ai/api/onedesk/get/tickets` — Retrieve tickets from OneDesk by querying a range of item IDs. **API LIMITATION WORKAROUND**: The OneDesk Public API does not provide a direct endpoint to list all tickets. This action works around th
  - body: { end_id?: integer, start_id?: integer, max_tickets?: integer }
- `POST https://api.mcp.ai/api/onedesk/get/timesheet/details` — Tool to retrieve details of a specific timesheet entry. Use when you have the `timesheet_id` and need full metadata (user, project, hours, dates). Tries multiple endpoint/header variants and gracefull
  - body: { timesheet_id: integer }
- `POST https://api.mcp.ai/api/onedesk/get/worklogs` — Retrieve a list of worklogs from OneDesk with optional filtering and pagination. This action attempts to list worklogs by trying multiple candidate endpoints and parameter formats. Note: The OneDesk P
  - body: { limit?: integer, offset?: integer, to_date?: string, user_id?: string, from_date?: string, object_id?: string }

## Example prompts
- "What can I do in Onedesk?"
- "Show me a summary of my Onedesk account"

## More
- Page: https://mcp.ai/onedesk
- Agent spec (llms.txt): https://mcp.ai/onedesk/llms.txt
- Postman collection: https://mcp.ai/onedesk/postman.json