Monday.com MCP Server
A lightweight MCP Server for seamless integration with Monday.com, enabling MCP clients to interact with boards, items and other Monday.com resources. Developed by sofias tech.
Features
This server provides a clean interface to Monday.com resources through the Model Context Protocol (MCP), with built-in caching for improved performance.
Tools
The server implements the following tools:
Get_Board_Schema: Retrieves the schema of a Monday.com board including columns, groups, and tagsGet_Item_Details: Fetches detailed information about a specific item by its IDGet_Items_by_Column_Value: Searches for items based on a specific column valueCreate_Item: Creates a new item in a specified group within a boardUpdate_Item: Updates column values for an existing itemDelete_Item: Removes an item from a board
Architecture
The server is built with resource efficiency in mind:
- Clear separation between resource management and tool implementation
- Simple and maintainable codebase under 30 lines per module
Setup
- Create a personal API token in Monday.com by following the instructions in the Monday.com API documentation
- Identify your board ID from the URL of your Monday.com board (e.g., if the URL is
https://your-workspace.monday.com/boards/12345678, the board ID is12345678)
Environment Variables
The server requires these environment variables:
MONDAY_API_KEY: Your Monday.com personal API tokenMONDAY_BOARD_ID: The ID of your default board
Quickstart
Installation
pip install -e .
Or install from PyPI once published:
pip install mcp-monday-server
Using uv:
uv pip install mcp-monday-server
Claude Desktop Integration
To integrate with Claude Desktop, update the configuration file:
On Windows: %APPDATA%/Claude/claude_desktop_config.json
On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Standard Integration
"mcpServers": {
"monday": {
"command": "mcp-monday-server",
"env": {
"MONDAY_API_KEY": "your-monday-api-key",
"MONDAY_BOARD_ID": "your-default-board-id"
}
}
}
Using uvx
"mcpServers": {
"monday": {
"command": "uvx",
"args": [
"mcp-monday-server"
],
"env": {
"MONDAY_API_KEY": "your-monday-api-key",
"MONDAY_BOARD_ID": "your-default-board-id"
}
}
}
Development
Requirements
- Python 3.10+
- Dependencies listed in
requirements.txtandpyproject.toml
Local Development
- Clone the repository
- Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
- Install development dependencies:
pip install -e .
- Create a
.envfile with your Monday.com credentials:MONDAY_API_KEY=your-monday-api-key MONDAY_BOARD_ID=your-default-board-id - Run the server:
python -m mcp_monday_server
Debugging
For debugging the MCP server, you can use the MCP Inspector:
npx @modelcontextprotocol/inspector -- python -m mcp_monday_server
License
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 sofias tech
Metadata
Release files for mcp-monday-server 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_monday_server-0.1.1.tar.gz | 4.6 kB | Without provenance | Details for mcp_monday_server-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_monday_server-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for mcp_monday_server-0.1.1-py3-none-any.whl |
Total release size: 10.9 kB
Release files / mcp_monday_server-0.1.1.tar.gz
| Download URL | mcp_monday_server-0.1.1.tar.gz |
|---|---|
| Size | 4.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50cdf0b0567773bd4c1fd357df2ea7f697295851af1c183e2623ea5730f3d58a
|
|
BLAKE2b-256 checksum How to use checksums |
3a7ff276821be20c7e181789250647d42de211397819e3a92b132b9f8efc2fa1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.5
|
Release files / mcp_monday_server-0.1.1-py3-none-any.whl
| Download URL | mcp_monday_server-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
60d981014a76c541575c2aeb35f42dc2895c33281229193a82ab1e51de8e9c09
|
|
BLAKE2b-256 checksum How to use checksums |
074ea428ad6993eb55afc3e5bff967d62b882704a723a97167506d47112cbdfb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.5
|
Security for mcp-monday-server 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.