Skip to main content

awork MCP Server

awork MCP server – how to connect your AI tool with awork

Written by Max Raschke

Bring awork right into your AI conversations.

With the MCP Server, you can connect your awork workspace directly to ChatGPT, Claude or most other AI tools, 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.

Capabilities

The awork MCP Server allows access to all capabilities of awork. The AI tool can execute tools to retrieve data from awork or trigger actions such as creating projects, and much more.

Permissions

The awork MCP Server uses the same permissions as your user in awork. For example, it can only see the projects you can see.

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 ChatGPT

In ChatGPT, go to Apps and search for awork, then click Connect. Follow the steps to log in with your awork account.

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

  1. Open Claude

  2. Click Settings

  3. Open Connectors

2. Create a new connector

  1. Choose Customise

  2. Click the + button

  3. Select Create custom connector

  4. Enter awork as the name

  5. Save the connector

3. Authenticate and use

  1. Authenticate with your awork account when prompted

  2. In a new chat, make sure the awork connector is active

  3. 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

  1. Open Codex

  2. Click Settings

  3. Open MCP servers

2. Add the awork server

  1. Click Add server

  2. Enter awork as the server name

  3. Choose Streamable HTTP as the type

  4. Leave the remaining fields blank

  5. Save the server

3. Authenticate and use

  1. Authenticate with your awork account once after saving

  2. In a supported conversation, make sure the awork server is active

  3. 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. In this case, be aware that the MCP Server uses Admin permissions.

See our Developer Docs for details.

Did this answer your question?