@mondaydotcomorg/monday-api-mcp 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# Monday.com API MCP Server
+
+A server implementation for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) that provides an interface to interact with Monday.com API.
+
+## Usage
+
+```bash
+@mondaydotcomorg/monday-api-mcp -t abcd123
+```
+
+### Command Line Arguments
+
+| Argument | Flags | Description | Required | Default |
+|----------|-------|-------------|----------|---------|
+| Monday API Token | `--token`, `-t` | Monday.com API token | Yes | - |
+| API Version | `--version`, `-v` | Monday.com API version | No | `current` |
+| Read Only Mode | `--read-only`, `-ro` | Enable read-only mode | No | `false` |
+| 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` |
+
+## Example Integration with Cursor
+
+```json
+{
+  "mcpServers": {
+    "monday-api-mcp": {
+      "command": "npx",
+      "args": [
+        "@mondaydotcomorg/monday-api-mcp -t abcd123"
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+## License
+
+MIT 

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { MondayAgentToolkit } from '@mondaydotcomorg/agent-toolkit/mcp';
+import { parseArgs, validateArgs } from './utils/args/args.service.js';
+/**
+ * Initializes and starts the MCP server with the Monday Agent Toolkit
+ * Uses stdio for transport
+ */
+async function runServer() {
+    const args = process.argv.slice(2);
+    const parsedArgs = parseArgs(args);
+    const validatedArgs = validateArgs(parsedArgs);
+    const toolkit = new MondayAgentToolkit({
+        mondayApiToken: validatedArgs.token,
+        mondayApiVersion: validatedArgs.version,
+        mondayApiRequestConfig: {},
+        toolsConfiguration: {
+            readOnlyMode: validatedArgs.readOnlyMode,
+            enableDynamicApiTools: validatedArgs.enableDynamicApiTools,
+        },
+    });
+    const transport = new StdioServerTransport();
+    await toolkit.connect(transport);
+}
+runServer().catch((error) => {
+    console.error('Fatal error in main():', error);
+    process.exit(1);
+});

package/dist/utils/args/args.config.js

@@ -0,0 +1,29 @@
+export const ARG_CONFIGS = [
+    {
+        name: 'token',
+        flags: ['--token', '-t'],
+        description: 'Monday API token',
+        required: true,
+    },
+    {
+        name: 'version',
+        flags: ['--version', '-v'],
+        description: 'Monday API version',
+        required: false,
+        defaultValue: 'current',
+    },
+    {
+        name: 'readOnlyMode',
+        flags: ['--read-only', '-ro'],
+        description: 'Enable read-only mode',
+        required: false,
+        defaultValue: false,
+    },
+    {
+        name: 'enableDynamicApiTools',
+        flags: ['--enable-dynamic-api-tools', '-edat'],
+        description: '(Beta) Enable dynamic API tools (Mode that includes the whole API schema, not supported when using read-only mode)',
+        required: false,
+        defaultValue: false,
+    },
+];

package/dist/utils/args/args.service.js

@@ -0,0 +1,41 @@
+import { ARG_CONFIGS } from './args.config.js';
+/**
+ * Parse command line arguments based on the defined configurations
+ * @param args Command line arguments (process.argv.slice(2))
+ * @returns Object with parsed arguments
+ */
+export function parseArgs(args) {
+    const result = {};
+    ARG_CONFIGS.forEach((config) => {
+        let argValue;
+        for (const flag of config.flags) {
+            const flagIndex = args.findIndex((arg) => arg === flag);
+            if (flagIndex !== -1 && flagIndex + 1 < args.length) {
+                argValue = args[flagIndex + 1];
+                break;
+            }
+        }
+        result[config.name] = argValue;
+    });
+    return result;
+}
+/**
+ * Validates required arguments and displays error messages for missing ones
+ * @param parsedArgs The parsed arguments to validate
+ * @returns Strongly typed validated arguments
+ */
+export function validateArgs(parsedArgs) {
+    const missingArgs = ARG_CONFIGS.filter((config) => config.required && !parsedArgs[config.name]);
+    if (missingArgs.length > 0) {
+        console.error('Error: The following required arguments are missing:');
+        missingArgs.forEach((config) => {
+            console.error(`  - ${config.name}: ${config.description}`);
+            console.error('    You can provide it using:');
+            const flagsString = config.flags.join(' or ');
+            console.error(`     ${flagsString} command line argument`);
+        });
+        process.exit(1);
+    }
+    // At this point, all required args are present, so we can safely cast
+    return parsedArgs;
+}

package/dist/utils/args/args.types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@mondaydotcomorg/monday-api-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for using the monday.com API",
+  "license": "MIT",
+  "author": "Anthropic, PBC (https://anthropic.com)",
+  "homepage": "https://modelcontextprotocol.io",
+  "bugs": "https://github.com/modelcontextprotocol/servers/issues",
+  "type": "module",
+  "bin": {
+    "mcp-server-monday-api": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "watch": "tsc --watch",
+    "start": "npm run build && node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mondaycom/monday-graphql-api/tree/main/packages/monday-api-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "@mondaydotcomorg/agent-toolkit": "^0.1.2",
+    "@types/node": "^22",
+    "@types/node-fetch": "^2.6.12",
+    "node-fetch": "^3.3.2",
+    "universal-user-agent": "^7.0.2"
+  },
+  "devDependencies": {
+    "shx": "^0.3.4",
+    "typescript": "^5.6.2"
+  }
+}