MCP 服务器

monday-mcp

A lightweight MCP server that provides a focused set of tools for interacting with monday.com's GraphQL API, enabling users to manage boards, items, users, and updates from AI assistants.

README

monday-mcp

A lightweight, independent Model Context Protocol (MCP) server for interacting with the monday.com GraphQL API from MCP-compatible AI assistants and development tools. It exposes a focused set of explicit, validated tools and sends fixed GraphQL operations to monday.com; clients cannot inject arbitrary GraphQL.

What is monday-mcp?

monday-mcp is a lightweight Python MCP server that provides a focused set of tools for common monday.com workflows. It is built around:

A standard MCP interface over stdio.
Predefined GraphQL operations for users, teams, workspaces, boards, groups, columns, items, and updates.
Explicit confirmWrite: true confirmation for every data-changing tool.
Straightforward local configuration through the MONDAY_API_TOKEN environment variable.

It is an independent open-source project and is not affiliated with, endorsed by, sponsored by, or maintained by monday.com Ltd.

Features

Identify the authenticated user and search users and teams.
List workspaces and boards; inspect a board's groups and columns.
List board items with cursor pagination; retrieve an item and its updates.
Create items, rename them, update their column values, and move them between groups.
Post updates and replies.
Require confirmWrite: true for every data-changing tool.
Keep the API token in the MCP client's environment, not in command-line arguments.
Use standard stdio MCP transport.

Architecture

flowchart TD
  A["MCP client or AI assistant"] --> B["monday-mcp (stdio)"]
  B --> C["monday.com GraphQL API"]
  C --> D["monday.com workspace"]

Quick start

git clone https://github.com/<your-account>/monday-mcp.git
cd monday-mcp
uv sync

Create a monday.com personal API token with access to the boards and users you need. Then add this server to an MCP client configuration:

{
  "mcpServers": {
    "monday-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/monday-mcp",
        "monday-mcp"
      ],
      "env": {
        "MONDAY_API_TOKEN": "replace_with_your_monday_api_token"
      }
    }
  }
}

Restart or reload the MCP client, then ask it to list your boards, inspect a board, create an item, update its status, or move it to another group. See installation for a complete setup and examples for prompts.

Configuration

MONDAY_API_TOKEN is required. Set it in your MCP client's env configuration; do not commit a real token or pass one on the command line. See configuration.

Documentation

Security

The server reads the token only from MONDAY_API_TOKEN at startup and sends it only as the authorization header for requests to https://api.monday.com/v2. Every tool that creates or modifies data requires confirmWrite: true; grant the token only the access it needs. See SECURITY.md.

Roadmap

Version 1.0.0 supports essential workspace, board, item, user/team, and update workflows. It intentionally does not expose arbitrary GraphQL, board administration, file upload, OAuth, webhooks, or account administration.