How mondaycom/mcp works
Project type and purpose
• This is a monorepo containing two related npm packages:
• @mondaydotcomorg/monday-api-mcp: a CLI/server that implements the MCP (Model Context Protocol) to let AI agents talk to monday.com’s API.
• @mondaydotcomorg/agent-toolkit: a TypeScript toolkit for building AI agents that orchestrate monday.com operations (both standard and dynamic GraphQL tools).
• Its purpose is to provide an open-source framework for AI agent developers to integrate with monday.com: the MCP server acts as a protocol bridge, and the toolkit offers reusable tools, codegen, utilities, and test suites.
File structure
• Top-level config files (.eslintrc.json, prettier, GitHub workflows, turbo.json) show it uses Yarn/Turbo for monorepo builds and CI/CD for publishing and version checks.
• The packages directory holds two sub-packages:
• agent-toolkit: with codegen scripts, rollup bundler, GraphQL config, a src folder structured into core, mcp, monday-graphql, openai, utils, plus tests.
• monday-api-mcp: with a CLI entrypoint (src/index.ts), an args parser, utility modules under utils/args, and tests.
• Scripts and config (jest.config, tsconfig) indicate a TypeScript-first codebase, built into dist for publishing.
• README and docs folder contain usage/installation guides and version-bumping process.
README for additional insights
• The overview explains two main deliverables: the MCP server package and the Agent Toolkit package.
• It lists categories of “Available Tools” (Item Operations, Board Operations, Account Operations, WorkForms Operations) and “Dynamic API Tools.”
• It describes how to run the MCP server locally or point an MCP-compatible client (Claude Desktop, Cursor) to it.