@mondaydotcomorg/monday-api-mcp 0.1.6 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +30 -10
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -1,11 +1,27 @@
1
+ <div align="center" id="top">
2
+
1
3
  # Monday.com API MCP Server
2
4
 
5
+ </div>
6
+
3
7
  A server implementation for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) that provides an interface to interact with Monday.com API.
4
8
 
5
- ## Usage
9
+ ## 💻 Claude Desktop Demo
10
+
11
+ https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd
12
+
13
+ ## Prerequisites
14
+
15
+ Before running the MCP server, make sure you have:
16
+
17
+ 1. Node v20 or higher installed
18
+ 2. NPM v5.2.0 or higher installed
19
+ 3. [monday.com API key](https://developer.monday.com/api-reference/docs/authentication)
20
+
21
+ ## ⚙️ Usage
6
22
 
7
23
  ```bash
8
- @mondaydotcomorg/monday-api-mcp -t abcd123
24
+ npx @mondaydotcomorg/monday-api-mcp -t abcd123
9
25
  ```
10
26
 
11
27
  The Monday API token can also be provided via the `monday_token` environment variable.
@@ -19,7 +35,7 @@ The Monday API token can also be provided via the `monday_token` environment var
19
35
  | Read Only Mode | `--read-only`, `-ro` | Enable read-only mode | No | `false` |
20
36
  | Dynamic API Tools | `--enable-dynamic-api-tools`, `-edat` | (Beta) Enable dynamic API tools (Mode that includes the whole API schema, not supported when using read-only mode) | No | `false` |
21
37
 
22
- ## Example Integration with Cursor
38
+ ## 💻 Claude Desktop Integration
23
39
 
24
40
  ```json
25
41
  {
@@ -27,15 +43,18 @@ The Monday API token can also be provided via the `monday_token` environment var
27
43
  "monday-api-mcp": {
28
44
  "command": "npx",
29
45
  "args": [
30
- "@mondaydotcomorg/monday-api-mcp -t abcd123"
31
- ],
32
- "env": {}
46
+ "@mondaydotcomorg/monday-api-mcp",
47
+ "-t",
48
+ "abcd123"
49
+ ]
33
50
  }
34
51
  }
35
52
  }
36
53
  ```
37
54
 
38
- ### Example Integration with Claude Desktop
55
+ ## 💻 Cursor Integration
56
+
57
+ ### Using command line arguments
39
58
 
40
59
  ```json
41
60
  {
@@ -46,13 +65,14 @@ The Monday API token can also be provided via the `monday_token` environment var
46
65
  "@mondaydotcomorg/monday-api-mcp",
47
66
  "-t",
48
67
  "abcd123"
49
- ]
68
+ ],
69
+ "env": {}
50
70
  }
51
71
  }
52
72
  }
53
73
  ```
54
74
 
55
- ### Example Using Environment Variable
75
+ ### Using environment variable
56
76
 
57
77
  ```json
58
78
  {
@@ -72,4 +92,4 @@ The Monday API token can also be provided via the `monday_token` environment var
72
92
 
73
93
  ## License
74
94
 
75
- MIT
95
+ This project is licensed under the MIT License - see the LICENSE file for details.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mondaydotcomorg/monday-api-mcp",
3
- "version": "0.1.6",
3
+ "version": "1.0.0",
4
4
  "description": "MCP server for using the monday.com API",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -15,12 +15,12 @@
15
15
  "watch": "tsc --watch",
16
16
  "start": "yarn build && node dist/index.js",
17
17
  "test": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js --config jest.config.js",
18
- "prettier": "prettier --write \"lib/**/*.ts\" --ignore-path \"../../.prettierignore\"",
19
- "lint": "eslint --fix \"lib/**/*.ts\" --ignore-path \"../../.eslintignore\""
18
+ "prettier": "prettier --write \"src/**/*.ts\" --ignore-path \"../../.prettierignore\"",
19
+ "lint": "eslint --fix \"src/**/*.ts\" --ignore-path \"../../.eslintignore\""
20
20
  },
21
21
  "repository": {
22
22
  "type": "git",
23
- "url": "https://github.com/mondaycom/monday-graphql-api/tree/main/packages/monday-api-mcp"
23
+ "url": "https://github.com/mondaycom/monday-ai/tree/master/packages/monday-api-mcp"
24
24
  },
25
25
  "dependencies": {
26
26
  "@modelcontextprotocol/sdk": "^1.7.0",