awork MCP Server
Connect your awork workspace with ChatGPT or Claude using the awork MCP Server to access tasks, projects, and docs directly from AI conversations.
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 awork MCP Server, your AI assistant can act as your personal awork assistant and trigger actions in awork or retrieve data.
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, for example, that it can only see the projects you have access to.
MCP Server URL
Use this URL to connect to 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 functionality 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 functionality 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 once with your awork account
-
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 receive admin rights this way.
You can find technical details in the Developer Docs.
FAQ
What is an MCP Server and why do I need the awork MCP Server?
MCP (Model Context Protocol) allows you to integrate external data into AI tools like Claude or ChatGPT. With the awork MCP Server, you can access your awork project data directly in your chosen LLM tool without having to manually export anything.
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. The MCP server will receive admin rights in this case.
