Skip to content

README.md

Latest commit

 

History

History
425 lines (308 loc) · 14.9 KB

README.md

File metadata and controls

425 lines (308 loc) · 14.9 KB

Monday Developer Tools

Monday Developer Tools

Monday.com project management for Cursor IDE -- boards, items, sprints, and the full GraphQL API.

Version Release License Docs

Validate CodeQL

Stars Issues

21 skills • 8 rules • ~45 MCP tools

Compatibility

Environment Status Notes
Cursor IDE Fully supported Install from marketplace or symlink locally
Claude Code Partial Skills and rules work; MCP tools require manual config
Other MCP Clients Partial Monday MCP plugin works in any MCP-compatible client

Quick Start

Open Cursor and try these prompts:

Create a new board called "Q3 Sprint" with Status, Person, and Timeline columns

Show me a summary of all items in my "Product Roadmap" board grouped by status

Set up a sprint board for the next two-week iteration starting Monday

How It Works

flowchart LR
    A[User Prompt] --> B[Cursor Agent]
    B --> C{Skill Match}
    C --> D[SKILL.md Workflow]
    D --> E[Monday MCP Tools]
    E --> F[Monday.com API]
    F --> G[Result]
    B --> H[Rules Engine]
    H --> I[Lint & Guard]
Loading

The plugin provides skills (step-by-step workflows) and rules (guardrails) that guide the Cursor agent. Skills call the official Monday.com MCP plugin, which handles authentication and GraphQL execution.

Skills

21 Skills -- full catalog

Core

Skill Description
monday-board-management Create, configure, duplicate, archive, delete boards; columns, groups, permissions
monday-item-operations Create, update, move, archive, delete items and subitems
monday-workspace-organizer Workspaces, folders, board hierarchy
monday-api-reference GraphQL schema, query building, pagination, complexity budgets

Views & Reporting

Skill Description
monday-dashboard-builder Create dashboards, widgets, chart types, connect boards
monday-board-insights Aggregate, filter, analyze board data for reporting
monday-chart-visualization Render pie/bar charts, battery widgets from board data

Collaboration

Skill Description
monday-updates-and-communication Post updates, replies, mentions; read update history
monday-docs-management Create, read, append Monday Docs; version history
monday-notifications Bell and email notifications

Dev & Sprints

Skill Description
monday-sprint-planning Sprint boards, metadata, iteration planning
monday-sprint-review Completed sprint analysis, velocity, burndown
monday-notetaker-meetings Meeting notes, summaries, action items, transcripts

Automation

Skill Description
monday-workflow-automation Automation recipes, triggers, conditions, actions
monday-form-builder Forms, questions, conditional logic
monday-webhook-management Webhook CRUD, challenge verification, JWT auth

Project Management

Skill Description
monday-project-tracking Timeline, dependencies, critical path, status reporting
monday-resource-management Team assignment, workload, capacity planning

Administration

Skill Description
monday-user-and-team-management Users, teams, permissions, roles
monday-column-types-guide Column type reference, value formats
monday-tags-and-assets Tag management, file/asset operations

Rules

8 Rules -- guardrails and best practices
Rule What It Catches
API Token Safety Flag hardcoded API tokens, OAuth secrets, webhook signing secrets
GraphQL Best Practices Flag over-fetching, missing pagination, unbounded queries
Rate Limit Awareness Flag missing retry/backoff, unbounded API loops, missing complexity budgets
Column Value Format Flag malformed column value JSON for status, date, timeline, people columns
Webhook Validation Flag missing challenge verification, unvalidated payloads, exposed URLs
MCP Tool Preference Flag raw fetch/axios calls to api.monday.com when MCP tools are available
Board Structure Flag too many columns, missing groups, inconsistent naming
Error Handling Flag unchecked API responses, missing error parsing

Monday MCP Tools

This plugin leverages the official Monday.com MCP plugin (plugin-monday.com-monday). Install it from the Cursor Marketplace -- no custom MCP server required.

~45 tools -- full catalog

Context & Search

Tool What It Does
get_user_context Current user, favorites, relevant boards
search Search boards, documents, folders
list_users_and_teams Look up users and teams

Boards, Items & Updates

Tool What It Does
get_board_info Board metadata, structure, owners, views
get_board_items_page Paginated items with filters and search
board_insights Aggregate and analyze board data
create_board Create a new board
create_group Add a group to a board
create_column Add a column to a board
create_item Create items, subitems, or duplicates
change_item_column_values Update item column values
get_updates Read updates on items or boards
create_update Post updates with mentions
get_board_activity Board activity log

Workspaces & Folders

Tool What It Does
list_workspaces List/search workspaces
workspace_info Boards, docs, folders in a workspace
create_workspace Create a workspace
update_workspace Update workspace attributes
create_folder Create a folder
update_folder Update folder attributes
move_object Move boards/folders/overviews

Docs

Tool What It Does
read_docs Read doc content or version history
create_doc Create a doc in workspace or attached to item
add_content_to_doc Append markdown to a doc

Dashboards & Widgets

Tool What It Does
create_dashboard Create a dashboard
create_widget Add a widget to dashboard or board view
all_widgets_schema Widget type JSON schemas

Forms

Tool What It Does
create_form Create a form with response board
get_form Get form by token
update_form Update form settings, appearance, questions
form_questions_editor Create/update/delete individual questions

Sprints & Meetings

Tool What It Does
get_monday_dev_sprints_boards Discover sprint/tasks board pairs
get_sprints_metadata Sprint table from sprints board
get_sprint_summary Completed sprint analysis
get_notetaker_meetings Meeting notes and transcripts

API & Schema

Tool What It Does
get_graphql_schema Schema overview (read vs write)
get_type_details Details for a GraphQL type
get_column_type_info Column type metadata
all_monday_api Run arbitrary GraphQL (escape hatch)

UI Components

Tool What It Does
show-chart Render pie/bar charts
show-battery Render battery/progress indicators
show-table Render interactive board tables
show-assign Render assignment UI

Notifications

Tool What It Does
create_notification Send bell/email notifications

Installation

Prerequisites

  • Cursor IDE installed
  • Monday.com MCP plugin installed from the Cursor Marketplace

Option 1: Cursor Marketplace

Search for Monday Developer Tools in the Cursor plugin marketplace and install.

Option 2: Local Symlink

Clone this repo, then symlink into your Cursor plugins directory:

Windows (PowerShell -- run as Administrator):

New-Item -ItemType SymbolicLink `
  -Path "$env:USERPROFILE\.cursor\plugins\monday-developer-tools" `
  -Target "C:\path\to\Monday-Cursor-Plugin"

macOS / Linux:

ln -s /path/to/Monday-Cursor-Plugin \
  ~/.cursor/plugins/monday-developer-tools

Restart Cursor after symlinking.

Usage Examples

One prompt per skill
Skill Example Prompt
monday-board-management "Create a board called 'Engineering Tasks' with Status, Person, Priority, and Due Date columns"
monday-item-operations "Add three items to the 'To Do' group: Set up CI, Write tests, Deploy staging"
monday-workspace-organizer "Create a workspace called 'Product Team' and move boards 'Roadmap' and 'Bugs' into it"
monday-api-reference "Show me the GraphQL query to fetch all items with their column values from board 123456"
monday-dashboard-builder "Create a dashboard called 'Sprint Overview' with a status breakdown chart from my sprint board"
monday-board-insights "How many items are stuck in 'In Review' for more than 5 days on my tasks board?"
monday-chart-visualization "Show a pie chart of item status distribution for board 'Product Roadmap'"
monday-updates-and-communication "Post an update on item 789 mentioning @sarah: 'Design review complete, ready for dev'"
monday-docs-management "Create a Monday Doc called 'Sprint 12 Retro' with sections for Wins, Improvements, and Actions"
monday-notifications "Send a notification to the 'Engineering' team about the deployment freeze"
monday-sprint-planning "Set up a two-week sprint starting next Monday with items from the backlog board"
monday-sprint-review "Generate a sprint review for the last completed sprint -- velocity, completed items, carryover"
monday-notetaker-meetings "Summarize action items from today's standup meeting"
monday-workflow-automation "Create an automation: when Status changes to Done, move item to the 'Completed' group"
monday-form-builder "Build a bug report form with fields for severity, steps to reproduce, and expected behavior"
monday-webhook-management "Set up a webhook that fires when items are created on my 'Intake' board"
monday-project-tracking "Show the critical path and any blocked items on the 'Q3 Launch' project board"
monday-resource-management "Show team workload for next week -- who's overallocated?"
monday-user-and-team-management "List all users in the 'Design' team and their roles"
monday-column-types-guide "What's the correct JSON format to set a Timeline column value?"
monday-tags-and-assets "Tag all items in the 'Bugs' group with 'critical' and 'frontend'"

Configuration

Monday API Token

The Monday.com MCP plugin handles authentication. When you first use a Monday MCP tool, the plugin will prompt you to authenticate via the Monday.com OAuth flow.

Alternatively, set your API token in Cursor settings:

  1. Go to Monday.com > Admin > API
  2. Copy your personal API token
  3. Configure it in the Monday MCP plugin settings

What Works Without Auth

  • Reading skill documentation and workflows
  • Rule-based linting and code review
  • GraphQL query building guidance
  • Column value format reference

All MCP tool calls (creating boards, reading items, posting updates, etc.) require authentication.

Roadmap

Release plan
Version Milestone Status
v0.1.0 Foundation -- 6 core skills, 3 rules, plugin scaffold, tests, CI Done
v0.2.0 Views -- dashboard builder, board insights, chart visualization + column format rule Planned
v0.3.0 Collaboration -- updates, docs, notifications + webhook validation rule Planned
v0.4.0 Sprints -- planning, review, notetaker + error handling rule Planned
v0.5.0 Automation -- workflows, forms, webhooks + MCP tool preference rule Planned
v0.6.0 PM -- project tracking, resources, tags/assets + board structure rule Planned
v1.0.0 Stable -- all 21 skills, 8 rules, full test coverage Planned

Contributing

See CONTRIBUTING.md for guidelines on adding skills, rules, and tests.

Support

If this plugin saves you time, consider sponsoring the project.

Found a bug? Open an issue.

License

This project is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

See LICENSE for the full text.

API References

Monday.com developer resources

Built by TMHSDigital