redmine_create_issue
Create a Redmine issue with cache-aware ID resolution for project, tracker, and other fields.
Instructions
Create an issue with cache-aware id resolution.
Args:
project: numeric id or identifier slug (e.g. "claudecode").
tracker: numeric id or name (e.g. "Bug").
subject: required, must be non-empty.
description: optional issue body.
priority: optional id or name (e.g. "High"); defaults to
tracker default when empty.
status: optional id or name. Most fleets force initial status
via workflow; this is rarely needed.
assigned_to_id: optional Redmine user id; 0 means unassigned.
difficulty: optional engagement-mode level for the global
Difficulty custom field. Values: "Unclassified" /
"Easy" / "Normal" / "Hard". When omitted, the
field default-fills with "Unclassified" so auto-callers
don't trip the required-field validation. Silently no-ops on
fleets that don't have a Difficulty field configured.
held: optional boolean. True marks the issue as held (blocks
closing). False (default) leaves the Held field unset.
held_until: optional ISO-8601 date ("2026-10-01"). Sets the
Held Until custom field. Empty leaves it unset. Only
meaningful when held is True.
due_date: optional ISO-8601 date ("2026-05-17"). Empty leaves
it unset.
start_date: optional ISO-8601 date. Empty leaves it unset (Redmine
defaults to the creation date).
done_ratio: optional 0-100 progress percent. -1 (sentinel)
means unset; 0 is explicit "no progress yet."
custom_fields: optional list of {"id": <int>, "value": <str>}
entries for arbitrary custom fields. Accepts either a Python
list (preferred — Claude can pass it natively) or a JSON-
encoded string. Empty string means no custom-field changes
beyond what difficulty sets.
Returns the created issue or a structured validation error.
Honors REDMINE_MCP_READ_ONLY.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | No | ||
| status | No | ||
| project | Yes | ||
| subject | Yes | ||
| tracker | Yes | ||
| due_date | No | ||
| priority | No | ||
| difficulty | No | ||
| done_ratio | No | ||
| held_until | No | ||
| start_date | No | ||
| description | No | ||
| custom_fields | No | ||
| assigned_to_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |