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 boardmonday-get-board-groups: Retrieves all groups from a specified Monday.com boardmonday-create-update: Creates a comment/update on a Monday.com itemmonday-list-boards: Lists all available Monday.com boardsmonday-list-items-in-groups: Lists all items in specified groups of a Monday.com boardmonday-list-subitems-in-items: Lists all sub-items for given Monday.com itemsmonday-create-board: Creates a new Monday.com boardmonday-create-board-group: Creates a new group in a Monday.com boardmonday-move-item-to-group: Moves a Monday.com item to a different groupmonday-delete-item: Deletes a Monday.com itemmonday-archive-item: Archives a Monday.com itemmonday-get-item-updates: Retrieves updates/comments for a specific itemmonday-get-docs: Lists documents in Monday.com, optionally filtered by foldermonday-get-doc-content: Retrieves the content of a specific documentmonday-create-doc: Creates a new document in Monday.commonday-add-doc-block: Adds a block to an existing document
Setup
- Create and save a personal API Token in Monday.com by following the instructions here.
- 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 ismyworkspace.
Quickstart
Using Rube
- Go to (Rube.app)[https://rube.app/]
- Install Rube in your preferred client including Cursor, Claude, VS Code, Windsurf etc.,
- Complete authentication with Rube
- You can now execute actions on Monday.com like creating items, posting updates, moving items
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"
]
}
}
```
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:```bash
uv sync
2. Build package distributions:```bash
uv build
This will create source and wheel distributions in the dist/ directory.
- Publish to PyPI:```bash
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:```bash
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.
