MCP Server

Manage your Plate tasks directly from AI assistants — Claude, Cursor, Windsurf, and any MCP-compatible client.

Endpoint https://plate.to/mcp

Setup

The Plate MCP server uses OAuth 2.0 — your AI client handles authentication automatically when you first connect. No API keys needed.

Add this to your MCP configuration file:

{
  "mcpServers": {
    "plate": {
      "type": "http",
      "url": "https://plate.to/mcp"
    }
  }
}

Client	Config file location
Claude Code	`.mcp.json` in project root, or `~/.claude/.mcp.json` globally
Claude Desktop	macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Cursor	Settings → Cursor Settings → MCP
Windsurf	Windsurf Settings → MCP Servers

After adding the server, your client will prompt you to authorize via browser. Sign in with your Plate account and choose a scope. To revoke access, go to Workspace Settings → Apps in Plate.

Authentication

Plate uses OAuth 2.0 with PKCE. When you first use a Plate tool, your client opens a browser window where you sign into your Plate account and approve access. You receive an access token (valid 1 hour) and a refresh token (valid 30 days). Refresh is handled automatically — you won't be asked to re-authorize unless the refresh token expires.

Scopes

Scope	Permissions
`read`	View workspaces, projects, tasks — no changes allowed
`read write`	Full access: view and create/update tasks, projects, and comments

Tools

Read tools are always available. Write tools require the write scope.

list_workspaces read

Returns all Plate workspaces the authenticated user belongs to.

[{
  "id": "ws_abc",
  "name": "Acme Corp",
  "urlId": "acme",
  "taskPrefix": "SCA"
}]

list_projects read

Returns all projects in a workspace.

Parameter	Type	Description
`workspaceId`*	string	Workspace ID from `list_workspaces`

[{
  "id": "proj_xyz",
  "name": "Backend",
  "description": null
}]

list_sections read

Returns all sections in a project, ordered by position.

Parameter	Type	Description
`projectId`*	string	Project ID from `list_projects`

[{
  "id": "list_abc",
  "name": "To Do",
  "order": 0
}]

list_tasks read

Returns tasks in a project. Excludes completed tasks by default.

Parameter	Type	Description
`projectId`*	string	Project ID
`statusId`optional	string	Filter by status
`listId`optional	string	Filter by section
`includeCompleted`optional	boolean	Include completed tasks (default: `false`)

[{
  "id": "task_123",
  "number": 42,
  "name": "Fix login bug",
  "isCompleted": false,
  "statusId": "status_abc",
  "assigneeId": "user_xyz",
  "listId": "list_abc",
  "projectId": "proj_xyz",
  "workspaceId": "ws_abc",
  "createdAt": "2025-01-15T10:00:00.000Z"
}]

get_task read

Returns full details of a single task, including its rich text description and label list. When description is not empty, it is returned as a structured node array — extract the text fields from leaf nodes to get plain text.

Parameter	Type	Description
`taskId`*	string	Task ID

list_members read

Returns all members of a workspace. Use userId as assigneeId when creating or updating tasks.

Parameter	Type	Description
`workspaceId`*	string	Workspace ID from `list_workspaces`

[{
  "userId": "user_abc",
  "name": "Jane Smith",
  "email": "jane@acme.com",
  "role": "member"
}]

list_statuses read

Returns workflow statuses for a workspace. Use the returned id as statusId when creating or updating tasks.

Parameter	Type	Description
`workspaceId`*	string	Workspace ID from `list_workspaces`

[{
  "id": "status_abc",
  "name": "In Progress",
  "color": "#4fa3e0",
  "systemType": null,
  "order": 1
}]

create_task write

Creates a new task in a project section. Returns the new task ID and its auto-assigned number.

Parameter	Type	Description
`projectId`*	string	Project ID
`listId`*	string	Section ID from `list_sections`
`name`*	string	Task name
`statusId`optional	string	Initial status ID
`assigneeId`optional	string	Assignee user ID

{ "id": "task_456", "number": 43 }

Free plan: max 300 tasks per workspace. Pro: unlimited.

update_task write

Updates one or more fields on a task. Only the fields you provide are changed.

Parameter	Type	Description
`taskId`*	string	Task ID
`name`optional	string	New task name
`statusId`optional	string	New status ID. Also updates `isCompleted`.
`assigneeId`optional	string \| null	New assignee. Pass `null` to unassign.
`listId`optional	string	Move task to a different section. Must belong to the same project.
`description`optional	string	New description. Markdown supported.

{ "id": "task_123" }

complete_task write

Marks a task as completed or re-opens it. Automatically sets the status to the system "done" or "todo" status.

Parameter	Type	Description
`taskId`*	string	Task ID
`isCompleted`optional	boolean	`true` to complete, `false` to reopen (default: `true`)

{ "id": "task_123", "isCompleted": true }

delete_task write

Permanently deletes a task. Comments and attachments are removed automatically.

Parameter	Type	Description
`taskId`*	string	Task ID

{ "id": "task_abc", "deleted": true }

create_project write

Creates a new project with a default "To Do" section. Returns the project ID and the default section ID.

Parameter	Type	Description
`workspaceId`*	string	Workspace ID
`name`*	string	Project name
`description`optional	string	Project description (plain text)

{ "id": "proj_new", "defaultListId": "list_new" }

Free plan: max 3 projects per workspace. Pro: unlimited.

update_project write

Renames a project or updates its description.

Parameter	Type	Description
`projectId`*	string	Project ID
`name`optional	string	New project name
`description`optional	string \| null	New description, or `null` to clear

{ "id": "proj_abc" }

create_section write

Creates a new section in a project.

Parameter	Type	Description
`projectId`*	string	Project ID
`name`*	string	Section name

{ "id": "section_abc" }

update_section write

Renames a section.

Parameter	Type	Description
`sectionId`*	string	Section ID
`name`*	string	New section name

{ "id": "section_abc" }

create_comment write

Adds a comment to a task. The comment is posted as the authenticated user.

Parameter	Type	Description
`taskId`*	string	Task ID
`text`*	string	Comment text. Markdown supported.

{ "id": "comment_abc" }

delete_comment write

Deletes a comment from a task.

Parameter	Type	Description
`commentId`*	string	Comment ID

{ "id": "comment_abc", "deleted": true }

Text Formatting

The description field in update_task and the text field in create_comment accept markdown. It is converted to rich text and rendered in the Plate editor.

Syntax	Result
`# Heading`	Heading 1
`## Heading`	Heading 2
`### Heading`	Heading 3
`- item` or `* item`	Bullet list item
`1. item`	Numbered list item
`> text`	Blockquote
`text`	Bold
`text`	Italic
`*text*`	Bold + italic
`~~text~~`	Strikethrough
`text`	Inline code

Blank lines separate blocks. Consecutive plain lines without a blank line between them are merged into a single paragraph.

# Example description
"## Steps to reproduce\n\n- Open settings\n- Click Profile\n\n**Expected:** profile page opens\n**Actual:** 404 error"

# Renders as:
#   Heading 2: "Steps to reproduce"
#   Bullet: "Open settings"
#   Bullet: "Click Profile"
#   Paragraph with bold "Expected:" and "Actual:" inline

Errors

All tools throw a descriptive error string on failure. Common causes:

Error message	Cause
`Access denied or workspace not found`	The authenticated user is not a member of the requested workspace
`Task not found`	Invalid task ID, or task belongs to a different workspace
`Project not found`	Invalid project ID
`Section not found`	Invalid section ID, or section belongs to a different project
`Free plan limit reached: 300 tasks maximum`	Workspace is on the free plan and has reached the task limit
`Free plan limit reached: 3 projects maximum`	Workspace is on the free plan and has reached the project limit

Questions? Write to us at hello@plate.to