How to add monday.com MCP to Windsurf

Official monday.com MCP server — agents create boards and items, update columns, and run GraphQL against your work OS. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 412★ · stdio · apikey · official

Windsurf config for monday.com MCP

npx @mondaydotcomorg/monday-api-mcp@latest

{
  "mcpServers": {
    "monday-com-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "<your-monday-api-token>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the monday.com MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5monday.com MCP's tools become available to Cascade.

Before you start

Node.js v20+ and npm (for the local server; the hosted endpoint needs neither)
A monday.com API token: avatar → Developers → My access tokens (local mode)
For hosted OAuth with workspace controls: install the monday MCP app from the monday.com marketplace

What monday.com MCP can do in Windsurf

create_item

Create a new item in a board with specified column values

delete_item

Permanently delete an item from a board

get_board_items_by_name

Search items in a board by name/term

create_update

Add an update/comment to an item

change_item_column_values

Modify column values of an existing item

move_item_to_group

Move an item to a different group in the same board

create_board

Create a new monday.com board with specified columns

get_board_schema

Retrieve a board's column and group structure

Security

A personal API token carries the full permissions of your monday.com user — prefer the hosted server's OAuth app (installable from the monday marketplace, with workspace-level access controls) for tighter scoping, or run locally with --read-only when you only need retrieval. Dynamic API tools bypass the curated tool list and require full API access, so enable them deliberately.

monday.com MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the monday.com MCP config there under the "mcpServers" key and restart the client.

Is monday.com MCP safe to use with Windsurf?

Is the monday.com MCP server official and free?

Yes — it's built and maintained by monday.com's AI team, MIT-licensed, and free to use; calls simply count against your account's normal monday.com API limits. The hosted endpoint at mcp.monday.com/mcp is the recommended production path.

Hosted or local — which should I use?

Hosted (https://mcp.monday.com/mcp) for OAuth, workspace access controls, automatic updates, and zero maintenance. Run the npm package locally when you need to customize the source, use flags like --mode apps or --enable-dynamic-api-tools, or develop offline.

Can I stop the agent from changing my boards?

Yes — start the local server with --read-only and only retrieval tools are exposed. Note the beta dynamic API tools require full access and are explicitly incompatible with read-only mode, so you can't combine the two.

View repo Full monday.com MCP page