Linked Monday Provider

Linked Monday Provider is an MCP server that connects AI assistants to Monday.com's work management platform, enabling conversational interaction with boards, items, columns, and automation workflows. This MCP bridge allows language models to create and manage work items, update statuses, query board data, and coordinate team workflows through natural language commands, bringing AI-powered project management to Monday.com users.

When to Use This MCP Server

Connect this server when...

• Your team uses Monday.com for project management and you want AI assistance creating, updating, and organizing work items
• You need conversational access to Monday.com board data for reporting, status updates, and team coordination
• You are building automated workflows that create Monday.com items from external triggers like emails or form submissions
• You want to generate status reports and project summaries from Monday.com board data using natural language
• You need to manage column values, labels, and people assignments across multiple Monday.com boards

Consider alternatives when...

• Your project management lives in Jira, Trello, or Asana, which have their own dedicated MCP servers
• You only need to view Monday.com boards without programmatic modification capabilities
• You require advanced Monday.com automations that go beyond API-level operations

Quick Start

Copy
# .mcp.json configuration
{
  "mcpServers": {
    "monday": {
      "command": "npx",
      "args": ["-y", "@monday/mcp-server"],
      "env": {
        "MONDAY_API_TOKEN": "your-api-token"
      }
    }
  }
}

Connection setup:

1. Log in to Monday.com and navigate to your profile avatar > Administration > API
2. Generate a personal API token or create an integration-specific token
3. Add the configuration above to your .mcp.json file with your token
4. Restart your MCP client to connect to Monday.com

Example tool usage:

# List board items
> Show me all items in the "Sprint Board" with status "Working on it"

# Create a work item
> Add a new item to the Development board titled "Fix login timeout" assigned to Sarah

# Update status
> Change the status of "Database migration" to "Done" on the Backend Tasks board

Core Concepts

Concept	Purpose	Details
Boards	Work containers	Monday.com boards organize items into customizable views with columns, groups, and filters
Items	Work entries	Individual tasks, projects, or records within a board with customizable column values
Columns	Data fields	Typed fields (status, people, date, text, numbers) that define the data schema for board items
Groups	Item organization	Named sections within a board that organize items into categories like "To Do" or "This Sprint"
Workspaces	Team scope	Organizational containers that group boards, dashboards, and team members together

Architecture:

+------------------+       +------------------+       +------------------+
|  Monday.com      |       |  Monday MCP      |       |  AI Assistant    |
|  GraphQL API     |<----->|  Server (npx)    |<----->|  (Claude, etc.)  |
|  api.monday.com  | HTTPS |  stdio transport  | stdio |                  |
+------------------+       +------------------+       +------------------+
        |
        v
+------------------------------------------------------+
|  Workspaces > Boards > Groups > Items > Columns       |
+------------------------------------------------------+

Configuration

Parameter	Type	Default	Description
MONDAY_API_TOKEN	string	(required)	Monday.com API token for authenticating GraphQL requests
default_board_id	string	none	Default board ID for operations when not explicitly specified
default_workspace	string	none	Default workspace ID to scope board listings and operations
complexity_limit	integer	10000000	Monday.com API complexity budget per minute to prevent rate limiting
include_subitems	boolean	false	Whether to include subitems when querying board items

Best Practices

1. Use board IDs for reliable targeting. Board names can be duplicated across workspaces. Always reference boards by their numeric ID (visible in the board URL) for consistent operations. Ask the AI to list boards first to discover IDs for your target boards.

2. Respect Monday.com API complexity limits. Monday.com's GraphQL API uses a complexity-based rate limiting system rather than simple request counts. Complex queries that fetch many columns across many items consume more complexity budget. Structure queries to request only the columns you need.

3. Leverage column types for structured updates. Monday.com columns have specific types (status, people, date, dropdown) with their own update formats. When updating items, ensure the AI formats values correctly for each column type to avoid update failures.

4. Group items logically for effective querying. Monday.com groups act as filters when querying board data. Organize items into meaningful groups (sprints, phases, teams) so the AI can efficiently query subsets of board data without loading the entire board.

5. Use subitems for hierarchical work breakdown. Enable subitems for boards where tasks have subtasks. The include_subitems flag allows the AI to see the full work breakdown structure, providing better context for status reporting and dependency analysis.

Common Issues

"Not authenticated" error when connecting. Verify your API token is valid and active. Monday.com tokens do not expire but can be regenerated (which invalidates the old token). Check your token at the Monday.com admin panel and update your configuration if it has been regenerated.

Board queries return partial column data. Monday.com's GraphQL API requires explicit column selection. If specific columns are missing from results, the query may not be requesting them. Ask the AI to fetch the board schema first, then request specific columns by ID.

Updates fail with "column value format" errors. Each Monday.com column type expects a specific JSON format for updates. Status columns require label text or index values, people columns require user IDs, and date columns require ISO format strings. Verify the column type and expected format before attempting updates.