Create a task
Create a task related to a record, with priority and due date.
MCP tool suitecrm_write → create_task
write
Creates the task assigned to your user, shown in the Activities tile of the record it relates to. It reaches no one else and is undone in one call with close_task, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| subject string required | string | Name of the task. |
| status string | string | One of: Not Started, In Progress, Completed, Pending Input, Deferred. |
| priority string | string | One of: High, Medium, Low. |
| due_date string | string | ISO date. |
| related_to_module string | string | Module of the record it belongs to: Accounts, Contacts, Leads, Opportunities or Cases. |
| related_to_id string | string | Record ID of the record it belongs to. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "suitecrm_write",
"arguments": {
"operation": "create_task",
"arguments": {
"subject": "Send revised quote to Northwind Dental",
"status": "Not Started",
"priority": "High",
"due_date": "2026-10-28",
"related_to_module": "Opportunities",
"related_to_id": "8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": "b6f3a290-1d84-4c7e-8e5a-2f9d0c71a4b3",
"subject": "Send revised quote to Northwind Dental",
"status": "Not Started",
"priority": "High",
"due_date": "2026-10-28",
"related_to": {
"module": "Opportunities",
"id": "8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61",
"name": "Northwind Dental: onboarding"
}
},
"isError": false
}