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

  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.

See our Developer Docs for details.

Did this answer your question?