CoWork MCP Server

The Model Context Protocol lets Claude call your CoWork workspace as tools. Endpoint uses Streamable HTTP and includes safety annotations (readOnly / destructive hints) on every tool.

Authentication

Option A — API key: Generate a key in Dashboard → Settings. Send Authorization: Bearer ck_… on every MCP request.

Option B — OAuth 2.0 (Claude.ai): Authorization URL https://www.cowork.com/oauth/authorize with response_type=code, client_id=cowork_mcp (or claude_mcp, mcp), registered redirect URI, and optional PKCE. Exchange code at https://www.cowork.com/api/oauth/token. Revoke at https://www.cowork.com/api/oauth/revoke.

Claude Desktop (manual config)

Add to claude_desktop_config.json (macOS example path: ~/Library/Application Support/Claude/). Replace YOUR_KEY.

{
  "mcpServers": {
    "cowork": {
      "url": "https://www.cowork.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_COWORK_API_KEY"
      }
    }
  }
}

Tools

All tool names are under 64 characters. Destructive tools may write data or call external AI.

Tool	Read-only hint	Description
list_workspaces	Yes	List workspaces with agent/task stats
get_workspace	Yes	Workspace detail + deployed agents
browse_agents	Yes	Marketplace search
list_playloops	Yes	PlayLoops and truncated steps
get_library	Yes	Library items (truncated content)
get_briefing	Yes	Summary stats + top agents
hire_agent	No	Returns ADAO estimate + confirmUrl on cowork.com
create_playloop	No	Returns confirmUrl to finish on cowork.com
chat_with_agent	No	Send chat message; persists in workspace
save_to_library	No	Add note or URL to library

Example prompts (3+)

1. Workspaces & PlayLoops

User prompt

"Show me my CoWork workspaces and how my PlayLoops are doing."

Claude should call list_workspaces, then list_playloops with your chosen workspaceId, and summarize status and progress.

2. Marketplace search

User prompt

"Search the CoWork marketplace for a content strategist agent."

Use browse_agents with search: "content strategist" or category: "content".

3. Chat with a deployed agent

User prompt

"In workspace 5, ask my agent to draft a blog outline about AI productivity."

Use get_workspace to confirm agents and pluginId, then chat_with_agent with workspaceId, message, and optional pluginId.

Troubleshooting

401: Missing or invalid Bearer token — rotate key in Settings or complete OAuth.
Empty tools: Ensure the MCP client supports Streamable HTTP and sends JSON-RPC to POST https://www.cowork.com/api/mcp.
Hire / PlayLoop: Tools return confirmUrl — billing is completed on cowork.com, not inside Claude.