# GoCanvas MCP by usefulapi

> GoCanvas MCP by usefulapi is an MCP server. Read GoCanvas forms, submissions, users, dispatches and reference data; create dispatches. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/gocanvas/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gocanvas
- **MCP Registry name:** io.usefulapi/gocanvas
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gocanvas.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gocanvas": {
      "url": "https://gocanvas.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/gocanvas-mcp-by-usefulapi
