Monday.com

What is mcp-server-monday?

mcp-server-monday is a Micro-Context Protocol (MCP) server designed to facilitate interaction with Monday.com boards and items. It allows MCP clients to programmatically manage various aspects of Monday.com, including boards, items, updates, and documents.

How to use mcp-server-monday?

To use mcp-server-monday, you need to set up your Monday.com API token and workspace name. The server can be installed and run in several ways:

1. Claude Desktop: Configure mcpServers in your Claude Desktop configuration file (claude_desktop_config.json) to use uvx or docker to run the server, providing your MONDAY_API_KEY and MONDAY_WORKSPACE_NAME as environment variables.
2. Smithery: Automatically install the server for Claude Desktop using the Smithery CLI: npx -y @smithery/cli install @sakce/mcp-server-monday --client claude.

Key Features of mcp-server-monday

mcp-server-monday provides a comprehensive set of tools for managing Monday.com data:

• Item Management: Create, list, move, delete, and archive items and sub-items.
• Board and Group Management: Create new boards and groups, retrieve existing board groups.
• Update/Comment Management: Create updates on items and retrieve existing item updates.
• Document Management: List documents, retrieve document content, create new documents, and add blocks to existing documents.

Use Cases of mcp-server-monday

This server is ideal for automating tasks and integrating Monday.com with other systems. Potential use cases include:

• Automated Task Creation: Automatically create new tasks or projects in Monday.com based on external triggers.
• Reporting and Data Extraction: Programmatically retrieve data from Monday.com boards for reporting or analysis.
• Workflow Automation: Integrate Monday.com with other tools to automate complex workflows, such as creating an item in Monday.com when a new email arrives.
• Custom Dashboards: Build custom dashboards or applications that display and interact with Monday.com data.

FAQ about mcp-server-monday

Q: What is an MCP Server? A: An MCP (Micro-Context Protocol) Server allows applications to interact with specific services (like Monday.com in this case) through a standardized protocol, enabling seamless integration and automation.

Q: How do I get my Monday.com API Token? A: You can create and save a personal API Token in Monday.com by following the instructions in their API reference documentation under the "Authentication" section.

Q: Where can I find my Monday.com Workspace Name? A: Your workspace name is part of your Monday.com URL. For example, if your URL is https://myworkspace.monday.com/, then myworkspace is your workspace name.

Q: How can I debug the mcp-server-monday? A: For the best debugging experience, it is recommended to use the MCP Inspector. You can launch it via npx @modelcontextprotocol/inspector uv run mcp-server-monday and access the provided URL in your browser.

Monday.com MCP server

MCP Server for monday.com, enabling MCP clients to interact with Monday.com boards, items, updates, and documents.

Components

Tools

The server implements the following tools:

• monday-create-item: Creates a new item or sub-item in a Monday.com board
• monday-get-board-groups: Retrieves all groups from a specified Monday.com board
• monday-create-update: Creates a comment/update on a Monday.com item
• monday-list-boards: Lists all available Monday.com boards
• monday-list-items-in-groups: Lists all items in specified groups of a Monday.com board
• monday-list-subitems-in-items: Lists all sub-items for given Monday.com items
• monday-create-board: Creates a new Monday.com board
• monday-create-board-group: Creates a new group in a Monday.com board
• monday-move-item-to-group: Moves a Monday.com item to a different group
• monday-delete-item: Deletes a Monday.com item
• monday-archive-item: Archives a Monday.com item
• monday-get-item-updates: Retrieves updates/comments for a specific item
• monday-get-docs: Lists documents in Monday.com, optionally filtered by folder
• monday-get-doc-content: Retrieves the content of a specific document
• monday-create-doc: Creates a new document in Monday.com
• monday-add-doc-block: Adds a block to an existing document

Setup

1. Create and save a personal API Token in Monday.com by following the instructions here.
2. Get the Workspace Name from the URL of your Monday.com workspace. For example, if the URL is https://myworkspace.monday.com/, the workspace name is myworkspace.

Quickstart

Install

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Using uvx

"mcpServers": {
  "monday": {
    "command": "uvx",
    "args": [
      "mcp-server-monday"
    ],
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_WORKSPACE_NAME": "your-monday-workspace-name"
    }
  }
}

Using Docker

"mcpServers": {
  "monday-docker": {
    "command": "docker",
    "args": [
      "run", 
      "--rm", 
      "-i", 
      "-e",
      "MONDAY_API_KEY=your-monday-api-key",
      "-e",
      "MONDAY_WORKSPACE_NAME=your-monday-workspace-name",
      "sakce/mcp-server-monday"
    ]
  }
}

Using Smithery

To install Monday.com MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @sakce/mcp-server-monday --client claude

Development

Building and Publishing

To prepare the package for distribution:

1. Sync dependencies and update lockfile:

uv sync

2. Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory.

3. Publish to PyPI:

uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv run mcp-server-monday

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.