MCP Server
Connect your awork workspace with ChatGPT, Claude, or other AI chats - and access tasks, projects, docs, and more directly from your AI conversations.
With the MCP Server, your AI assistant can act as your personal awork assistant and trigger actions or retrieve data in awork.
Key benefits and use cases
After connecting, you can use your AI assistant to, for example:
-
Find and summarize tasks or projects ("Summarize the Website Redesign project from awork")
-
Work with docs ("Find the Client Report doc in awork and check it for errors")
-
Get an overview of current tasks
-
Prepare status updates based on project information
All actions respect your existing permissions and access rights in awork.
Features
The awork MCP Server gives you access to all awork features. The AI tool can perform actions to retrieve data from awork or trigger processes - for example, create projects and much more.
Permissions
The awork MCP Server uses the same permissions as your user account in awork. This means it can only see projects that you have access to, for example.
MCP Server URL
Use this URL to connect with the awork MCP Server:
https://api.awork.com/api/v1/mcp
How to connect awork with ChatGPT
-
Open Apps in ChatGPT
-
Search for awork
-
Click Connect
-
Follow the instructions to sign in with your awork account
How to connect awork with Claude
Setup only takes a few steps.
Note: Claude's custom connector feature is continuously being developed. Menu positions and feature scope may change.
1. Open Claude settings
-
Open Claude
-
Open Settings
-
Open Connectors
2. Create a new connector
-
Select Customize
-
Click +
-
Select Create custom connector
-
Enter
aworkas the name -
Enter
https://api.awork.com/api/v1/mcpas the URL -
Save the connector
3. Authenticate and get started
-
Authenticate with your awork account when prompted
-
In a new chat, make sure the awork connector is active
-
For example, ask: "Summarize the Website Redesign project from awork"
Depending on your Claude plan, usage limits may apply. You can find more information in the Claude support documentation.
How to connect awork with Codex
Setup only takes a few steps.
Note: MCP server support in Codex is continuously being developed. Menu positions and feature scope may change.
1. Open Codex settings
-
Open Codex
-
Open Settings
-
Open MCP servers
2. Add the awork server
-
Click Add server
-
Enter
aworkas the server name -
Select Streamable HTTP as the type
-
Enter
https://api.awork.com/api/v1/mcpas the URL -
Leave the remaining fields empty
-
Save the server
3. Authenticate and get started
-
After saving, authenticate with your awork account one time
-
In a supported chat, make sure the awork server is active
-
For example, ask: "Summarize the Website Redesign project from awork"
Other clients
The awork MCP Server works with all chat clients that support the Model Context Protocol - for example, 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. Keep in mind that the MCP server will have admin rights in this case.
You can find technical details in the Developer Docs.
FAQ
What is the awork MCP Server?
The awork MCP Server connects your awork workspace with AI chats like ChatGPT or Claude, so your AI assistant can access tasks, projects, docs, and more.
What permissions apply to the MCP Server?
The MCP Server uses the same permissions as your awork user account and only sees content that you have access to in awork.
What URL do I need to connect?
You use this MCP server URL: https://api.awork.com/api/v1/mcp.
Can I use the MCP Server with other clients?
Yes. The awork MCP Server works with all chat clients that support the Model Context Protocol, for example Claude Code or Copilot in Visual Studio Code.
What's important if my client doesn't support OAuth?
You can connect manually using an API key. In this case, the MCP server will have admin rights.
