Bring awork right into your AI conversations.
With the MCP Server, you can connect your awork workspace directly to Claude or Codex (ChatGPT), so your AI assistant can access tasks, projects, docs and more from your awork workspace.
What you can do with it
Once connected, your AI assistant can act as your personal awork assistant. You can ask it to:
Find and summarise tasks or projects ("Summarise the Website Redesign project from awork")
Work with Docs ("Find the Client Report Doc from awork and check it for errors")
Give you an overview of your current tasks
Help prepare status updates based on project information
All operations respect your existing permissions and access rights in awork.
MCP server URL
Use the following URL to connect to the awork MCP server.
https://api.awork.com/api/v1/mcp
How to connect awork to Claude
You can set this up in just a few steps.
Claude's custom connectors are under ongoing development and their location in the menu as well as their functionality might change.
1. Open Claude settings
Open Claude
Click Settings
Open Connectors
2. Create a new connector
Choose Customise
Click the + button
Select Create custom connector
Enter
aworkas the nameEnter
https://api.awork.com/api/v1/mcpas the URLSave the connector
3. Authenticate and use
Authenticate with your awork account when prompted
In a new chat, make sure the awork connector is active
For example, ask: "Summarise the Website Redesign project from awork"
💡 Limits may apply depending on your Claude plan. See the Claude support documentation for details.
How to connect awork to Codex
You can set this up in just a few steps.
Codex MCP server support is under ongoing development and their location in the menu as well as their functionality might change.
1. Open Codex settings
Open Codex
Click Settings
Open MCP servers
2. Add the awork server
Click Add server
Enter
aworkas the server nameChoose Streamable HTTP as the type
Enter
https://api.awork.com/api/v1/mcpas the URLLeave the remaining fields blank
Save the server
3. Authenticate and use
Authenticate with your awork account once after saving
In a supported conversation, make sure the awork server is active
For example, ask: "Summarise the Website Redesign project from awork"
Other clients
The awork MCP server should work with all chat clients that support the Model Context Protocol. This includes Claude Code, Copilot in Visual Studio Code, and others.
💡 You can also connect manually using an API key if your client doesn't support OAuth.
See our Developer Docs for details.

