
monday.com MCP
OfficialOfficial monday.com MCP server — agents create boards and items, update columns, and run GraphQL against your work OS.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx @mondaydotcomorg/monday-api-mcp@latestPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"monday-com-mcp": {
"command": "npx",
"args": [
"@mondaydotcomorg/monday-api-mcp@latest"
],
"env": {
"MONDAY_TOKEN": "<your-monday-api-token>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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
About monday.com MCP
The repo is a monorepo from monday.com's AI team containing the MCP server (@mondaydotcomorg/monday-api-mcp) and an agent toolkit (@mondaydotcomorg/agent-toolkit) that implements the same tools for both MCP and OpenAI function-calling — useful if you're building a custom agent rather than plugging into Claude or Cursor.
For most users the hosted endpoint is the sensible default: add https://mcp.monday.com/mcp to your client, authenticate via OAuth (the monday MCP marketplace app adds workspace-level access controls), and skip token management entirely. The local npm server exists for customization, offline work, --mode apps (which swaps in monday's Apps-Framework development tools), and contribution. Local config is one npx command plus a MONDAY_TOKEN env var; advanced hosted setups can pass Authorization or Api-Version headers through mcp-remote.
The standard tool set is deliberately curated — 14 tools for items, boards, groups, columns, updates, users/teams, and forms. The interesting escape hatch is Dynamic API Tools (beta): all_monday_api generates and executes arbitrary GraphQL, with get_graphql_schema and get_type_details for introspection, so an agent can do cross-board reporting or batch mutations the curated tools don't cover. That power comes with the documented caveat that it needs full API access and is incompatible with read-only mode.
Trade-offs to note: local-token mode inherits your user's permissions wholesale, API usage counts against monday.com rate limits, and the curated set has no delete-board or automation tools — by design. Node.js v20+ is required for the local server.
Tools & capabilities (17)
create_itemCreate a new item in a board with specified column values
delete_itemPermanently delete an item from a board
get_board_items_by_nameSearch items in a board by name/term
create_updateAdd an update/comment to an item
change_item_column_valuesModify column values of an existing item
move_item_to_groupMove an item to a different group in the same board
create_boardCreate a new monday.com board with specified columns
get_board_schemaRetrieve a board's column and group structure
create_groupCreate a new group in a board
create_columnAdd a new column to an existing board
delete_columnRemove a column from a board
list_users_and_teamsLook up users or teams by id, name, or search
create_formCreate a new monday.com WorkForm
get_formGet a WorkForm by its token
all_monday_apiGenerate and execute any GraphQL query or mutation (beta, dynamic mode)
get_graphql_schemaFetch monday.com's GraphQL schema (beta, dynamic mode)
get_type_detailsDetailed information about specific GraphQL types (beta, dynamic mode)
What this server can do
monday.com MCP provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Run sprint operations from chat: create items, move them between groups, and post status updates
- Scaffold a new project board with the right columns and groups from a description
- Cross-board reporting via dynamic GraphQL when the curated tools don't cover the query
- Create WorkForms for intake processes without opening the monday.com UI
Quick setup
- 1Fastest path — hosted: add {"mcpServers": {"monday-mcp": {"url": "https://mcp.monday.com/mcp"}}} to your client and complete the OAuth login
- 2Local alternative: copy an API token from monday.com (avatar → Developers → My access tokens)
- 3Add the local server: command npx, args ["@mondaydotcomorg/monday-api-mcp@latest"], env MONDAY_TOKEN
- 4Optionally append flags: --read-only for retrieval-only, or --enable-dynamic-api-tools true for full GraphQL access
- 5Test with "What items do I have in board <board-id>?"
Security notes
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 FAQ
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.
Alternatives to monday.com MCP
Compare all alternatives →AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.
Gives AI assistants deep knowledge of 2,000+ n8n nodes, plus optional workflow management on your own n8n instance.
Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.
Compare monday.com MCP with: