Use this tool to modify an existing monday.com WorkForm. Each call performs a single named action on the form — for example, updating the title and description, changing the layout, activating or deactivating the form, setting a password, or reordering questions. Pass only the fields relevant to the action you are performing; all fields not included in your call are left unchanged (patch semantics).

The typical form workflow is:

create_form — Create the form and get a formToken
form_questions_editor — Add, update, or delete questions
update_form ← You are here — Configure the form's title, appearance, features, and accessibility
get_form — Inspect the updated form state
create_form_submission — Submit a response

Parameters

Parameter	Type	Required	Description
formToken	`string`	Yes	The unique token identifying the form.
action	`string`	Yes	The operation to perform. See the table below for all supported actions and their required fields.
form	`object`	Conditional	Form data to update. Required for `updateFormHeader`, `updateAppearance`, `updateAccessibility`, `updateFeatures`, and `updateQuestionOrder`. Patch semantics — only include the fields you want to change.
formPassword	`string`	Conditional	Required for the `setFormPassword` action.
tag	`object`	Conditional	Required for `createTag`, `updateTag`, and `deleteTag`. For create: provide `name` and `value`. For update: provide `id` and new `value`. For delete: provide `id` only.

Supported actions:

Action	Required fields	Description
`activate`	—	Makes the form publicly accessible.
`deactivate`	—	Stops the form from accepting new responses.
`updateFormHeader`	`form.title`, `form.description`	Updates the form's title and description text.
`updateAppearance`	`form.appearance`	Sets background, layout, font, colors, and branding.
`updateAccessibility`	`form.accessibility`	Sets the form language and logo alt text.
`updateFeatures`	`form.features`	Configures submission behavior, password, response limit, close date, and more.
`updateQuestionOrder`	`form.questions`	Reorders questions. Must include all existing question IDs.
`setFormPassword`	`formPassword`	Enables password protection and sets the password.
`shortenFormUrl`	—	Generates a shortened `wkf.ms` URL for the form.
`createTag`	`tag.name`, `tag.value`	Adds a routing tag to the form.
`updateTag`	`tag.id`, `tag.value`	Updates an existing tag's value.
`deleteTag`	`tag.id`	Removes a tag from the form.

Example

Update the title and description of a form:

{
  "formToken": "your_form_token_here",
  "action": "updateFormHeader",
  "form": {
    "title": "MCP Docs Test Form",
    "description": "A test form created to demonstrate the monday.com MCP tools"
  }
}

The tool confirmed the action updateFormHeader succeeded and returned the updated title and description values.

Programmatic equivalent

monday.com WorkForms are managed through the monday.com interface or via the MCP. There is no direct GraphQL API equivalent for this operation.