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

  1. Open Apps in ChatGPT

  2. Search for awork

  3. Click Connect

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

  1. Open Claude

  2. Open Settings

  3. Open Connectors

2. Create a new connector

  1. Select Customize

  2. Click +

  3. Select Create custom connector

  4. Enter awork as the name

  5. Enter https://api.awork.com/api/v1/mcp as the URL

  6. Save the connector

3. Authenticate and get started

  1. Authenticate with your awork account when prompted

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

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

  1. Open Codex

  2. Open Settings

  3. Open MCP servers

2. Add the awork server

  1. Click Add server

  2. Enter awork as the server name

  3. Select Streamable HTTP as the type

  4. Enter https://api.awork.com/api/v1/mcp as the URL

  5. Leave the remaining fields empty

  6. Save the server

3. Authenticate and get started

  1. After saving, authenticate with your awork account one time

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

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

Last updated HappySupportPowered by happysupport.ai
© 2026 HappySupport. All rights reserved.