Skip to content
MCP server

GoCanvas MCP by usefulapi

Read GoCanvas forms, submissions, users, dispatches and reference data; create dispatches.

Install
Runs
Remotely
Version
1.19.0
Listing updated
4 days ago

About GoCanvas MCP by usefulapi

GoCanvas MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http gocanvas https://gocanvas.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://gocanvas.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gocanvas": {
      "url": "https://gocanvas.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gocanvas": {
      "type": "http",
      "url": "https://gocanvas.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gocanvas": {
      "serverUrl": "https://gocanvas.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gocanvas": {
      "type": "http",
      "url": "https://gocanvas.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (23)

Read directly from the server.

gocanvas_get_me
The user who owns the connected OAuth application: id, login, company id and name, default department and role. Use it to learn the default department id.
gocanvas_list_forms
Forms (mobile form definitions) the connected user can see: id, name, status, version, department. Paged, 100 per page. Use gocanvas_get_form for a form's fields (entries).
gocanvas_get_form
One form definition, including its screens and entries (field ids and labels). Use format 'flat' for the simplest list of fields (what you need to read submissions or create a dispatch), 'nested' (default) for the full structure, 'metadata' or 'minimal' for less.
gocanvas_list_form_reports
The report (PDF) definitions attached to a form: id, name, format, whether emailed by default. Paged.
gocanvas_list_submissions
Completed forms (submissions): id, form, number, created time, department, user, status. At least one of form_id, user_id or user_email is required (user_id and user_email cannot be combined). Default status is completed. Dates filter created_at. Paged, 100 per page. Use gocanvas_get_submission for the answers.
gocanvas_get_submission
One submission with all its responses (entry id, label, type, value). Accepts the numeric submission id or the client GUID.
gocanvas_list_submission_revisions
The revision history of a submission (who changed it and when). Paged.
gocanvas_list_users
Users of the company: id, name, email, enabled. Paged, 100 per page.
gocanvas_get_user
One user by id: name, login, contact data, default department and role.
gocanvas_list_departments
Departments of the company: id, name, description. The pseudo department -1 'All' is included.
gocanvas_list_department_users
The users in one department with their department role.
gocanvas_list_dispatches
Dispatches (jobs sent to field workers): id, form, assignee, status, schedule. At least one of user_id, department_id or form_id is required. Dates are ISO-8601. Paged.
gocanvas_get_dispatch
One dispatch by id with its pre-filled responses, schedule and status.
gocanvas_list_customers
Customers (contacts of the Project Management view): individuals or businesses, optionally tied to a site. Paged.
gocanvas_list_projects
Projects of the Project Management view. Paged.
gocanvas_list_sites
Sites (job locations) of the Project Management view. Paged.
gocanvas_list_reference_data
Reference data (lookup tables used by forms): id, name, columns, version. Without department_id the user's default department is used.
gocanvas_get_reference_data
One reference data set with its rows.
gocanvas_list_groups
User groups: id, name, and the forms and users assigned. Paged.
gocanvas_list_workflows
Workflows (handoff chains between users) the connected user takes part in, with their handoff states and the count of tasks available to claim. Paged.
gocanvas_list_locations
GPS location events of field users (needs the tracker feature). start_date and end_date are required and may span at most 7 days. Omit user_id for all users of the company. Paged.
gocanvas_create_dispatch
WRITE: creates a dispatch, a job that appears on the assignee's mobile device (immediate_dispatch is sent at once, with a push notification when send_notification is true; scheduled_dispatch needs scheduled_at and scheduled_end). Responses pre-fill the assignee's form (entry ids from gocanvas_get_form). Without assignee_id the dispatch stays unassigned. Not idempotent: calling twice creates two di
gocanvas_mark_dispatch_received
WRITE: acknowledges a dispatch (status becomes received). Only works for a dispatch in the assigned state that is assigned to the connected user; repeating it is refused by GoCanvas.

GoCanvas MCP by usefulapi FAQ

How do I add GoCanvas MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http gocanvas https://gocanvas.usefulapi.io/mcp