Monday MCP Server for Claude

Content

Streamline your project management and CRM workflows by connecting Claude to monday.com. Create and update board items, manage columns and structure, assign team members, set timelines, track CRM deals, query with advanced GraphQL filters, and automate workflows—all through natural language commands. Leverage monday.com's powerful API with complexity-aware queries and rate limit monitoring.

Features

• Create and update board items with full metadata (name, status, assignees, dates)
• Manage board columns and structure (add, update, configure column types)
• Assign owners and team members to items and boards
• Set timelines and deadlines with date column management
• Add CRM activities and track deals (pipeline management)
• Query boards, items, and groups with advanced GraphQL filters
• Manage workflows and automations programmatically
• Access workspace settings and user management (admin operations)
• Advanced Monday.com board and item management with workflow automation, team collaboration features, and analytics integration
• Batch operations support for efficient bulk item operations, board management, and workflow automation with automatic rate limit handling and retry logic
• Real-time board synchronization capabilities with webhook integration support for monitoring Monday.com events and triggering automated workflows

Use Cases

• Create project items from requirements with automatic metadata population
• Update task status across boards in bulk operations
• Assign team members to tasks based on workload and skills
• Track project timelines visually with deadline management
• Manage CRM pipeline and activities with deal tracking
• Query and filter boards using advanced GraphQL queries for project analysis
• Automate workflow transitions and status updates based on rules
• Sync monday.com data with external systems via API integration
• Build automated project management workflows that sync external systems with Monday.com for real-time task tracking and team collaboration

Installation

Claude Code

1. Get your Personal V2 API token from Developer Center (profile > Developers > API token)
2. claude mcp add --transport sse monday https://mcp.monday.com/sse
3. Authenticate with your API token when prompted (or configure in environment)
4. Verify installation: claude mcp list
5. Test connection: claude mcp status monday
6. Verify access: Ask Claude to list your boards

Claude Desktop

1. Get your Personal V2 API token from Developer Center (profile > Developers > API token)
2. Open Claude Desktop configuration file (see configPath below)
3. Add the Monday server configuration with SSE transport pointing to https://mcp.monday.com/sse
4. Add API token to environment variables or configuration
5. Restart Claude Desktop
6. Authenticate with monday.com when prompted
7. Verify access: Ask Claude to list your boards

Requirements

• monday.com workspace account (Member role required, not Guest)
• Personal V2 API token (generate from Developer Center or Administration tab) or OAuth credentials for hosted service
• SSE transport support (remote MCP server at https://mcp.monday.com/sse or local npx installation)
• Internet connection (remote monday.com API access required)
• Understanding of monday.com API rate limits (complexity: 10M points/minute for paid accounts, 1M for free/trial; daily calls: 200-25,000 depending on tier)
• Understanding of GraphQL query complexity limits (maximum 5M complexity points per individual query)
• Understanding of monday.com workspace permissions and board access settings
• Claude Desktop 0.7.0+ or Claude Code with MCP support
• Understanding of project management concepts (boards, items, columns, groups, workflows, CRM)
• Optional: Node.js installed for local npx installation (hosted service doesn't require this)

Configuration

{
  "monday": {
    "url": "https://mcp.monday.com/sse",
    "transport": "sse"
  }
}

Examples

Create a new item in the Projects board

Common usage pattern for this MCP server

Ask Claude: "Create a new item in the Projects board"

Update status to Done for item 12345

Common usage pattern for this MCP server

Ask Claude: "Update status to Done for item 12345"

Assign this task to the design team

Common usage pattern for this MCP server

Ask Claude: "Assign this task to the design team"

Add CRM activity for client meeting

Common usage pattern for this MCP server

Ask Claude: "Add CRM activity for client meeting"

Create Board Item

Create a new Monday.com board item with column values

// Create Monday.com board item
const item = await monday.items.create({
  board_id: "board-id",
  item_name: "New Task",
  column_values: {
    status: "Working on it",
    text: "Task description",
  },
});

Security

• Personal V2 API token authentication (tokens mirror UI permissions) or OAuth for hosted service
• Board-level permissions respected (token permissions match your account access)
• Audit log tracking for all changes (workspace activity logs)
• Regular permission reviews recommended (verify token access matches requirements)
• Monitor complexity and rate limit headers to avoid service disruption
• Monday.com API tokens and personal access tokens must be securely stored and never exposed in client-side code or public repositories - use environment variables and secure credential management
• Monday.com OAuth access tokens should be used for third-party integrations to ensure proper access control, token lifecycle management, and automatic token refresh
• Monday.com board, item, and workspace IDs may expose organizational structure and project information - ensure Monday.com resource identifiers are kept private and not shared in public configurations
• Rate limiting and API quota management are critical for Monday.com MCP servers - implement proper rate limit handling, retry logic, and quota monitoring to prevent service disruption
• Monday.com webhook configurations and payloads may contain sensitive board data and item information - ensure webhook endpoints are properly secured with authentication and HTTPS encryption

Troubleshooting

API rate limit exceeded - 429 error code returned

Complexity limit: 10M points/minute for paid accounts (personal API tokens), 1M for trial/free/NGO accounts. Daily call limits: 200 (free/trial), 1,000 (standard/basic), 10,000 (pro), 25,000 (enterprise). Check Retry-After header in response to see wait time. Monitor complexity using complexity query field. Reduce query complexity or split operations into smaller batches. Use page and limit arguments to paginate large result sets.

API token authentication fails or workspace access denied

Verify Personal V2 API token is correctly configured. Generate token from Developer Center (profile > Developers > API token) or Administration tab (for admins). Token permissions mirror your UI permissions. Verify workspace permissions allow API access. Check account has Member role (not Guest). For hosted service, ensure OAuth authentication is properly configured. Contact workspace admin to grant API permissions if needed.

GraphQL query complexity calculation too high

Individual query cannot exceed 5M complexity points. Reduce nested fields in queries. Limit items per query to 50-100. Use complexity { query before after } field to check costs before execution. Request only data you need. Split complex queries into multiple simpler requests. Utilize page and limit arguments for pagination. Check monday.com developer docs for complexity calculation guidelines.

Board or item permissions insufficient for operation

Verify your account has write permissions to specific board. Check board sharing settings allow modifications. Token permissions mirror your UI permissions (board, column, item, account level). Contact board owner to upgrade access level if read-only. Verify you're using correct workspace and board IDs in queries.

Monday.com MCP server authentication errors with API tokens

Verify API token is valid and not expired. Check token permissions match required operations. Ensure token format is correct (Bearer token in Authorization header). For OAuth integrations, verify token refresh logic is working correctly.

Monday.com rate limit errors when making multiple API calls

Implement exponential backoff retry logic with jitter. Use Monday.com API rate limit headers to monitor usage. Reduce concurrent requests. Cache frequently accessed board data. Monday.com allows 25 requests per minute per API token.

Monday.com board or item access denied errors

Verify API token has access to the board or item. Check board permissions and workspace membership. Ensure API token has required permissions for target operations.

Monday.com MCP server connection timeouts or network errors

Check network connectivity and firewall settings. Verify Monday.com API endpoints are accessible. Increase request timeout values. Implement connection pooling and retry mechanisms with exponential backoff.

• Source repositorygithub.com 2026-07-13T15:19:32-07:00
• Documentationdeveloper.monday.com
• Package (SHA-256 pinned)/downloads/mcp/monday-mcp-server.mcpb