---
title: "Add a custom MCP server"
description: "Connect a custom or local MCP server that is not available through OpenWork Connect"
---

Use this guide only when you need a custom or local MCP server that is not available through OpenWork Connect.

For Gmail, Google Calendar, Google Drive, Slack, Notion, Linear, and other
managed services, follow [Connect your services](/start-here/connect-your-stack/connect-services).

Connecting a custom app with OpenWork takes four clicks.

- In the desktop app, open `Settings` \> `Extensions`, then click `Add Custom App`

<Frame>
  ![Extensions page listing available and connected apps](/images/mcp-extensions-advanced-settings.png)
</Frame>

You can add the app to this workspace or to your global configuration for all workspaces.

<Frame>
  ![Add Custom App dialog with name, URL, and OAuth options](/images/mcp-add-server-dialog.png)

  Indicate whether the server requires OAuth.
</Frame>

This setup is intended for servers that support dynamic OAuth client registration.

<Frame>
  ![OAuth approval page for MCP server](/images/mcp-oauth-approval-page.png)
</Frame>

Complete the provider's OAuth approval flow in your browser. It should redirect
back to OpenWork. If a custom MCP needs behavior OpenWork does not support,
[open an issue](https://github.com/different-ai/openwork/issues/).

### Troubleshooting

Some MCP servers do not support dynamic client registration. If the server gives you a pre-registered OAuth client ID and client secret, add it through `Add Custom App` > `Advanced OAuth`.

For an advanced local Slack setup, follow
[Connect Slack as a custom MCP](/start-here/connect-your-stack/connect-slack-mcp).

<Frame>
  ![Error when MCP server does not support dynamic client registration](/images/mcp-dynamic-registration-error.png)
</Frame>
