Typeform

Typeform MCP Server for Cloudflare Workers

Available Tools

30 tools available in the Typeform MCP server. Each tool can be called by AI assistants to perform specific actions.

typeform_create_workspace

Create a new workspace.

Args:

name: Workspace name

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Workspace name"
    }
  }
}

typeform_get_theme

Get a single theme by ID.

Args:

themeId: Theme ID
format: Response format

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "themeId": {
      "type": "string",
      "description": "Theme ID"
    }
  }
}

typeform_test_connection

Test the connection to Typeform API.

Returns connection status and user information if successful.

{
  "type": "object",
  "properties": {}
}

typeform_get_me

Get the current user's information.

Returns the user's alias, email, and language setting.

{
  "type": "object",
  "properties": {}
}

typeform_list_forms

List forms from your Typeform account.

Returns a paginated list of forms with basic information.

Args:

page: Page number (1-based, default: 1)
pageSize: Results per page (1-200, default: 10)
search: Filter results containing this string
workspaceId: Filter forms in a specific workspace
sortBy: Sort by 'created_at' or 'last_updated_at'
orderBy: Sort order 'asc' or 'desc'
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "search": {
      "type": "string",
      "description": "Filter results containing this string"
    },
    "sortBy": {
      "enum": [
        "created_at",
        "last_updated_at"
      ],
      "type": "string",
      "description": "Sort field"
    },
    "orderBy": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort order"
    },
    "pageSize": {
      "type": "integer",
      "default": 10,
      "maximum": 200,
      "minimum": 1,
      "description": "Results per page"
    },
    "workspaceId": {
      "type": "string",
      "description": "Filter forms in a specific workspace"
    }
  }
}

typeform_get_form

Get a single form by its ID.

Returns the complete form configuration including fields, settings, and logic.

Args:

formId: The form ID (found in form URL)
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

typeform_create_theme

Create a new theme.

Args:

name: Theme name
colors: JSON object with colors { answer, background, button, question } (hex values)
font: Font name (e.g., 'Arial', 'Helvetica Neue')
hasTransparentButton: Whether buttons are transparent
roundedCorners: Corner style ('none', 'small', 'medium', 'large')

{
  "type": "object",
  "required": [
    "colors"
  ],
  "properties": {
    "font": {
      "type": "string",
      "description": "Font name"
    },
    "name": {
      "type": "string",
      "description": "Theme name"
    },
    "colors": {
      "type": "string",
      "description": "JSON object with colors { answer, background, button, question }"
    },
    "roundedCorners": {
      "enum": [
        "none",
        "small",
        "medium",
        "large"
      ],
      "type": "string"
    },
    "hasTransparentButton": {
      "type": "boolean"
    }
  }
}

typeform_create_form

Create a new form in Typeform.

Args:

title: Form title (required)
type: Form type ('form' or 'quiz')
workspaceHref: Workspace URL (e.g., 'https://api.typeform.com/workspaces/abc123')
themeHref: Theme URL (e.g., 'https://api.typeform.com/themes/abc123')
fields: JSON array of field definitions
settings: JSON object with form settings

Returns the created form with its ID.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "type": {
      "enum": [
        "form",
        "quiz"
      ],
      "type": "string",
      "description": "Form type"
    },
    "title": {
      "type": "string",
      "description": "Form title"
    },
    "fields": {
      "type": "string",
      "description": "JSON array of field definitions"
    },
    "settings": {
      "type": "string",
      "description": "JSON object with form settings"
    },
    "themeHref": {
      "type": "string",
      "description": "Theme URL"
    },
    "workspaceHref": {
      "type": "string",
      "description": "Workspace URL"
    }
  }
}

typeform_update_form

Update an existing form (full replacement).

WARNING: This overwrites the entire form. Include all existing fields with their IDs to preserve them.

Args:

formId: Form ID to update
title: Form title
fields: JSON array of all field definitions (include existing field IDs)
settings: JSON object with form settings

Returns the updated form.

{
  "type": "object",
  "required": [
    "formId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Form title"
    },
    "fields": {
      "type": "string",
      "description": "JSON array of all field definitions"
    },
    "formId": {
      "type": "string",
      "description": "Form ID to update"
    },
    "settings": {
      "type": "string",
      "description": "JSON object with form settings"
    }
  }
}

typeform_patch_form

Partially update a form (specific properties only).

Args:

formId: Form ID to update
operations: JSON array of patch operations [{ op: "replace", path: "/title", value: "New Title" }]

Common paths: /title, /settings/is_public, /workspace/href, /theme/href

{
  "type": "object",
  "required": [
    "formId",
    "operations"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID to update"
    },
    "operations": {
      "type": "string",
      "description": "JSON array of patch operations"
    }
  }
}

typeform_delete_form

Delete a form and all its responses.

WARNING: This permanently deletes the form and all collected responses.

Args:

formId: Form ID to delete

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID to delete"
    }
  }
}

typeform_get_form_messages

Get custom messages for a form.

Returns the customizable UI messages (button labels, error messages, etc.) for the form.

Args:

formId: Form ID

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

typeform_update_form_messages

Update custom messages for a form.

Args:

formId: Form ID
messages: JSON object with message key-value pairs

{
  "type": "object",
  "required": [
    "formId",
    "messages"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "messages": {
      "type": "string",
      "description": "JSON object with message key-value pairs"
    }
  }
}

typeform_list_responses

Get responses for a form.

Note: Very recent responses (within ~30 minutes) may not be returned.

Args:

formId: Form ID
pageSize: Results per page (1-1000, default: 25)
since: Filter responses submitted after this date (ISO 8601)
until: Filter responses submitted before this date (ISO 8601)
after: Pagination token for next page
before: Pagination token for previous page
completed: Filter by completion status
query: Search across all answer and hidden fields
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination token for next page"
    },
    "query": {
      "type": "string",
      "description": "Search across all fields"
    },
    "since": {
      "type": "string",
      "description": "Filter responses after this date (ISO 8601)"
    },
    "until": {
      "type": "string",
      "description": "Filter responses before this date (ISO 8601)"
    },
    "before": {
      "type": "string",
      "description": "Pagination token for previous page"
    },
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 25,
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page"
    },
    "completed": {
      "type": "boolean",
      "description": "Filter by completion status"
    }
  }
}

typeform_delete_responses

Delete specific responses from a form.

Args:

formId: Form ID
responseIds: Comma-separated list of response IDs to delete (max 1000)

{
  "type": "object",
  "required": [
    "formId",
    "responseIds"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "responseIds": {
      "type": "string",
      "description": "Comma-separated list of response IDs"
    }
  }
}

typeform_list_workspaces

List workspaces in your Typeform account.

Args:

page: Page number (1-based, default: 1)
pageSize: Results per page (1-200, default: 10)
search: Filter results containing this string
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "search": {
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 10,
      "maximum": 200,
      "minimum": 1
    }
  }
}

typeform_get_workspace

Get a single workspace by ID.

Args:

workspaceId: Workspace ID
format: Response format

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

typeform_update_workspace

Update a workspace (rename or manage members).

Args:

workspaceId: Workspace ID
operations: JSON array of patch operations

Examples: Rename: [{ "op": "replace", "path": "/name", "value": "New Name" }] Add member: [{ "op": "add", "path": "/members", "value": { "email": "user@example.com", "role": "member" } }] Remove member: [{ "op": "remove", "path": "/members", "value": { "email": "user@example.com" } }]

{
  "type": "object",
  "required": [
    "workspaceId",
    "operations"
  ],
  "properties": {
    "operations": {
      "type": "string",
      "description": "JSON array of patch operations"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

typeform_delete_workspace

Delete a workspace.

Args:

workspaceId: Workspace ID to delete

{
  "type": "object",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID to delete"
    }
  }
}

typeform_list_themes

List themes in your Typeform account.

Args:

page: Page number (1-based, default: 1)
pageSize: Results per page (1-200, default: 10)
format: Response format

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 10,
      "maximum": 200,
      "minimum": 1
    }
  }
}

typeform_update_theme

Update an existing theme.

Args:

themeId: Theme ID to update
name: New theme name
colors: JSON object with colors { answer, background, button, question }
font: Font name

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "font": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "colors": {
      "type": "string",
      "description": "JSON object with colors"
    },
    "themeId": {
      "type": "string",
      "description": "Theme ID to update"
    }
  }
}

typeform_delete_theme

Delete a theme.

Args:

themeId: Theme ID to delete

{
  "type": "object",
  "required": [
    "themeId"
  ],
  "properties": {
    "themeId": {
      "type": "string",
      "description": "Theme ID to delete"
    }
  }
}

typeform_list_images

List images in your Typeform account.

Returns all images stored in your account.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

typeform_get_image

Get image metadata by ID.

Args:

imageId: Image ID

{
  "type": "object",
  "required": [
    "imageId"
  ],
  "properties": {
    "imageId": {
      "type": "string",
      "description": "Image ID"
    }
  }
}

typeform_create_image

Upload a new image.

Provide either a base64-encoded image OR a URL, not both.

Args:

fileName: Image filename
image: Base64-encoded image data (without data:image prefix)
url: URL to an image to import

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to import image from"
    },
    "image": {
      "type": "string",
      "description": "Base64-encoded image data"
    },
    "fileName": {
      "type": "string",
      "description": "Image filename"
    }
  }
}

typeform_delete_image

Delete an image.

Args:

imageId: Image ID to delete

{
  "type": "object",
  "required": [
    "imageId"
  ],
  "properties": {
    "imageId": {
      "type": "string",
      "description": "Image ID to delete"
    }
  }
}

typeform_list_webhooks

List webhooks for a form.

Args:

formId: Form ID

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

typeform_get_webhook

Get a single webhook by tag.

Args:

formId: Form ID
tag: Webhook tag

{
  "type": "object",
  "required": [
    "formId",
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Webhook tag"
    },
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

typeform_create_webhook

Create or update a webhook for a form.

Args:

formId: Form ID
tag: Unique tag for this webhook
url: Destination URL for webhook payloads
enabled: Whether the webhook is active (default: true)
secret: Optional HMAC SHA256 signing key for payload verification
verifySsl: Whether to verify SSL certificates (default: true)
formResponse: Trigger on form submission (default: true)
formResponsePartial: Trigger on partial responses

{
  "type": "object",
  "required": [
    "formId",
    "tag",
    "url"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Unique webhook tag"
    },
    "url": {
      "type": "string",
      "description": "Destination URL"
    },
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "secret": {
      "type": "string",
      "description": "HMAC signing key"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "verifySsl": {
      "type": "boolean"
    },
    "formResponse": {
      "type": "boolean",
      "description": "Trigger on form submission"
    },
    "formResponsePartial": {
      "type": "boolean",
      "description": "Trigger on partial responses"
    }
  }
}

typeform_delete_webhook

Delete a webhook.

Args:

formId: Form ID
tag: Webhook tag to delete

{
  "type": "object",
  "required": [
    "formId",
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Webhook tag to delete"
    },
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}