Document monday.com MCP Server integration with MCP Gateway

[crivetimihai]

Overview

Document how to integrate the official monday.com MCP Server with MCP Gateway for productivity and project management workflows.

Server Details

• Provider: monday.com
• Category: Productivity
• Endpoint: https://mcp.monday.com/sse
• Authentication: OAuth2.1
• Protocol: Server-Sent Events (SSE)

Documentation Requirements

File Location

Create: docs/docs/using/servers/monday/monday-mcp.md

Content Structure

1. Overview

   • Introduction to monday.com MCP Server
   • Project management and productivity capabilities
   • Workflow automation and collaboration features

2. Prerequisites

   • monday.com account and workspace setup
   • OAuth application registration in monday.com
   • Required permissions and workspace access
   • Admin permissions for enterprise features

3. Authentication Setup

   • OAuth2.1 flow configuration for monday.com API
   • Client credentials management
   • Token refresh and expiration handling
   • Scope configuration for boards and workspaces

4. MCP Gateway Integration

   • Server registration in MCP Gateway
   • SSE endpoint configuration
   • Authentication middleware for OAuth2.1
   • Webhook integration for real-time updates

5. Available Tools

   • Board and item management operations
   • Column and field manipulation tools
   • User and team management
   • Workflow and automation tools
   • Time tracking and reporting
   • File and asset management

6. Usage Examples

   • Creating and managing boards
   • Adding and updating items
   • Managing project timelines
   • Team collaboration workflows
   • Automated status updates
   • Reporting and analytics

7. Troubleshooting

   • OAuth setup and permission issues
   • SSE connection and timeout problems
   • Rate limiting and API quotas
   • Workspace access and visibility issues

Configuration Examples

# MCP Gateway server configuration
servers:
  - id: "monday-official"
    name: "monday.com MCP Server"
    description: "Official monday.com productivity and project management tools"
    transport:
      type: "sse"
      endpoint: "https://mcp.monday.com/sse"
      auth:
        type: "oauth2"
        client_id: "${MONDAY_CLIENT_ID}"
        client_secret: "${MONDAY_CLIENT_SECRET}"
        scopes: ["boards:read", "boards:write", "users:read", "teams:read"]
        token_endpoint: "https://auth.monday.com/oauth2/token"
        authorize_endpoint: "https://auth.monday.com/oauth2/authorize"
    settings:
      timeout: 60
      retry_attempts: 3
      rate_limit_handling: true
      workspace_id: "${MONDAY_WORKSPACE_ID}"

# Webhook integration
webhooks:
  - endpoint: "https://mcp.monday.com/webhooks"
    events: ["item_created", "item_updated", "board_changed"]
    auth:
      type: "signature"
      secret: "${MONDAY_WEBHOOK_SECRET}"

Navigation Updates

Create docs/docs/using/servers/monday/.pages with:

title: monday.com
nav:
  - monday-mcp.md

Update main servers .pages to include monday.com section.

References

• monday.com MCP Server
• monday.com API Documentation
• monday.com OAuth Setup
• monday.com Webhooks Guide

Acceptance Criteria

• Comprehensive documentation file created
• OAuth2.1 authentication setup documented
• SSE endpoint integration guide provided
• Available monday.com tools and capabilities documented
• Configuration examples tested and verified
• Webhook integration for real-time updates documented
• Workspace and permission management covered
• Troubleshooting section with common issues
• Navigation structure updated
• Cross-references to monday.com developer resources

Priority

Medium - Part of 0.8.0 public server documentation initiative

Use Cases

• Project management and task tracking
• Team productivity and collaboration
• Workflow automation and process management
• Resource planning and allocation
• Time tracking and reporting
• Client and stakeholder communication
• Agile and sprint management