MCP blocks let you run actions from an MCP server inside a workflow. MCP (Model Context Protocol) is a standard that lets outside tools and services share their actions in a consistent way, so if a tool exists on an MCP server, you can use it as a step in your workflow. MCP blocks run the same way every time and don't use AI credits.
How MCP blocks work
MCP blocks connect to an MCP server with your credentials, list the actions it offers, and run the one you pick. The block runs every time your workflow triggers, and it returns the response as a raw JSON string. If you're not sure about a field, ask Smart builder to help you with it.
Choose the right MCP block
Not every MCP server signs in the same way, and that decides which block you use.
| Type | Block name | How you connect | What to know |
|---|---|---|---|
| API key | Run any MCP action | Provide a token or API key through a custom MCP connection. | Connects any MCP server that uses an API key. It supports token or API key servers only. |
| OAuth | Run any [X] action (MCP), such as Run any Slack action (MCP) | Sign in to the tool. | You don't need to ask for, find, or create an API key. |
Set up an MCP block
1Select the + where you want the step, choose Action, and search for "mcp".
2Select the block that matches your app: Run any MCP action for an API key, or Run any [X] action (MCP), such as Run any Slack action (MCP), for OAuth.
3Choose your connection. In Run any MCP action, use Choose app connection (MCP credentials). In an OAuth block, use the account field, such as Slack account. Pick an existing connection or add a new one. See Connect your account below.
4Under Action (MCP tool), select a tool, then fill in the fields that appear. You only need to fill the required fields, marked with a red asterisk.
Tools are the actions the MCP server can perform, and monday.com generates the list automatically. Some fields have a complex structure and ask for a JSON string. The field tells you when it does.
Connect your account
For either block type, add a new account or choose one from your list of existing accounts.
Connect with an API key (Run any MCP action)
If you add a new account, enter:
| Field | What to enter |
|---|---|
| Token / API key | Your authentication token for the MCP server. If a prefix is required, such as Bearer, add it before the token. |
| Connection name | A label for this connection, so you can add several connections and tell them apart. |
| MCP server URL | The base URL of the MCP server. It must be a public HTTPS server. |
| Auth header name | The header name the token is sent under. If you leave it empty, monday.com uses Authorization. |
Connect with OAuth (Run any [X] action (MCP))
If you add a new account, you're taken to a sign-in for the tool, where you authorize the connection to monday. The steps are the same for every OAuth MCP block, such as Run any Slack action (MCP).
Work with the response
The response from the MCP server arrives as a JSON string, not as separate values. To use it in later blocks, parse it into the values you need with the Code block.
MCP blocks don't use AI
MCP blocks run as a fully deterministic action. monday.com doesn't use an LLM to wrap or interpret the MCP call, so every run does the action in exactly the same way. This means:
- No AI credits are used.
- The behavior is predictable and reliable every time.
- The block works as a fetcher or an action block in any workflow.
FAQs
If you have any questions, please reach out to our team right here. We’re available 24/7 and happy to help.