Skip to main content
Glama
workast

Workast MCP

Official
by workast
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Workast MCP

CI

MCP host for Workast. Exposes Model Context Protocol tools over Streamable HTTP at /mcp.

Host

Mode

Auth

https://agent.workast.com/mcp

MCP_AUTH_MODE=agent (default)

Workast API key (Authorization: Bearer …)

https://mcp.workast.com/mcp

MCP_AUTH_MODE=user

OAuth at workast-auth; send the WAT as Authorization: Bearer wat::…

User-mode hosts discover OAuth via RFC 9728 Protected Resource Metadata at /.well-known/oauth-protected-resource. CIMD and token issuance live on workast-auth.

A workspace-scoped API key locks tools to that workspace. Create a key in Workast under Preferences → API.

Environment

Variable

Values

Default

MCP_AUTH_MODE

agent | user

agent

MCP_PUBLIC_ORIGIN

Public origin, no path (e.g. https://mcp.workast.com)

unset (request origin). Optional; required in production user-mode (and agent-mode for a stable challenge URL)

WORKAST_AUTH_URL

Issuer URL of workast-auth (same string as auth AUTH_URL / well-known issuer, e.g. https://my.workast.com)

required when mode is user

WORKAST_API_URL

Workast API origin passed to the SDK as baseUrl (for example http://localhost:8080)

SDK default (https://api.workast.com)

CUSTOMERIO_WRITE_KEY

Customer.io CDP write key

unset (analytics no-op)

CUSTOMERIO_HOST

Customer.io CDP host (for example https://cdp-eu.customer.io)

Customer.io default

LOG_LEVEL

pino log level

info

Related MCP server: Arc Todo MCP

Cursor

Add to your Cursor mcp.json:

{
  "mcpServers": {
    "workast": {
      "url": "https://agent.workast.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WORKAST_API_KEY}"
      }
    }
  }
}

Set WORKAST_API_KEY in your environment (or Cursor’s env config) to a Workast secret API key.

Tools

Tool

Description

workast_ping

Health check (requires auth)

workast_list_spaces

List active spaces (optional type, participants, includeArchived, limit, skip)

workast_create_space

Create a space (name, optional participants, privacy)

workast_add_space_participants

Add users to a space (spaceId, users)

workast_list_space_participants

List space participants (spaceId)

workast_create_sublist

Create a sublist (spaceId, name)

workast_list_coworkers

List teammates (limit, offset)

workast_about_me

Current user and team

workast_search_tasks

Search tasks with filters (spaceId, statusIs, limit, skip, …)

workast_retrieve_tasks

Get tasks (taskIds[] or shortIds[])

workast_create_tasks

Create tasks in a space (spaceId, tasks[])

workast_create_personal_tasks

Create personal tasks (tasks[], no spaceId)

workast_create_subtasks

Create subtasks (parentTaskId, subtasks[])

workast_update_tasks

Patch tasks (taskIds[] plus fields; no status)

workast_complete_tasks

Mark tasks done (taskIds[])

workast_create_comment

Comment on a task (taskId, comment)

workast_list_task_activity

Task activity (taskId, limit, skip)

workast_list_meetings

List meetings (startDateAfter, startDateBefore, optional participants, limit, pageToken)

workast_retrieve_meeting

Get a meeting (meetingId, optional includeTranscript)

workast_list_fields

List custom fields (optional spaceId)

workast_create_field

Create a field and enable it on a space (spaceId, name, type, optional options)

workast_list_reports

List saved reports (optional home, limit, skip)

workast_retrieve_report

Get a report and its tasks (reportId, getTasks default 25)

Paginated list and search tools accept page size and offset (limit/skip, or limit/offset for coworkers). Meetings use limit (sent as maxResults) and an optional pageToken. Those responses include has_more and the next page cursor (next_skip, next_offset, or nextPageToken) so clients can keep paging.

Local development

nvm use
npm install
cp .env.sample .env
npm test
npm run build
npm run dev

For agent mode, point the MCP Inspector or MCPJam at Streamable HTTP → http://localhost:3000/mcp and send an Authorization: Bearer <your-api-key> header.

For user mode, set MCP_AUTH_MODE=user and WORKAST_AUTH_URL (the workast-auth issuer) and connect Inspector/MCPJam to http://localhost:3000/mcp. Production user-mode URL: https://mcp.workast.com/mcp.

Run tool evals

mcp-eval-gateway scores LLM tool use against the in-process /mcp handler. It does not start next dev.

Copy .env.sample to .env and set AI_GATEWAY_API_KEY and WORKAST_API_KEY.

WORKAST_API_KEY is sent as the Bearer token. The starter ping task does not call the Workast API, so any non-blank value works for that task. Tasks that call Workast tools need a real workspace API key. Set WORKAST_API_URL when that API is not https://api.workast.com.

Then run the evals:

nvm use
npm run eval

The runner loads eval/config.ts and eval/tasks.yaml. The config sets a current-date systemPrompt. before archives active spaces whose names contain McpEval, holiday campaign, or comp planning (skipping spaces the token is not a participant of), seeds McpEval Marketing, McpEval Product, McpEval Design, and McpEval Bugs when missing, and reopens the three short-ID batch tasks. after archives those same spaces and deletes the write-eval tasks. Add tasks there as you add tools.

Contributing

See CONTRIBUTING.md. To report a vulnerability, see SECURITY.md.

License

MIT

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers