Monday.com Integration

Pro v1.0.0

Interact with Monday.com boards, items, and workflows via GraphQL API

Requires Claude Code CLI

This skill integrates with Monday.com through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Query Boards

List boards in your Monday.com account with metadata including columns, item counts, and state

Parameters

Name Type Required Description
limit integer Optional Maximum number of boards to return

Returns

array Array of board objects with id, name, description, columns, and item counts

Try saying...

  • "Show me my Monday.com boards"
  • "List the first 5 boards"
  • "What boards do I have in Monday?"

Query Items

Retrieve all items from a specific board including column values and metadata

Parameters

Name Type Required Description
board_id string Required The ID of the board to query

Returns

array Array of item objects with id, name, state, timestamps, and column values

Try saying...

  • "Show me all items on board 123456789"
  • "What tasks are on this board?"
  • "List items from the Product Roadmap board"

Create Item

Add a new item to a board, optionally with initial column values

Parameters

Name Type Required Description
board_id string Required The ID of the board to add the item to
item_name string Required The name/title of the new item
column_values object Optional JSON object with column IDs and values to set

Returns

object Created item object with id, name, and created_at timestamp

Try saying...

  • "Create a new task on board 123456789 called 'Review designs'"
  • "Add an item to the roadmap board"
  • "Create a task with status 'In Progress'"

Update Item

Update column values for an existing item

Parameters

Name Type Required Description
item_id string Required The ID of the item to update
board_id string Required The ID of the board containing the item
column_values object Required JSON object with column IDs and new values

Returns

object Updated item object with id, name, and updated column values

Try saying...

  • "Update item 987654321 status to Done"
  • "Change the owner of this task"
  • "Set the due date for item 987654321"

Query Current User

Get information about the authenticated user including account details

Returns

object User object with id, name, email, and account information

Try saying...

  • "Who am I authenticated as?"
  • "Show my Monday.com user info"
  • "What account am I connected to?"

Getting Started

API Key Easy Setup
  1. 1 Click your profile picture in Monday.com and select 'Developers'
  2. 2 Click 'API token' then 'Show'
  3. 3 Copy your personal token
  4. 4 Add to shell config: echo 'export MONDAY_API_KEY="YOUR_KEY"' >> ~/.zshrc
  5. 5 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py query-me

Success: Returns your user ID, name, email, and account information

View full setup guide

Security & Access

Access Scope

Full access to all boards, items, and data visible to your Monday.com user account. Can read, create, update, and delete resources based on your permissions.

  • Never commit API keys to version control
  • API keys inherit your full Monday.com permissions
  • Regenerating a key invalidates the previous one immediately
  • Personal tokens have the same permissions as your user account
  • Consider using app-specific tokens with limited scopes for production

Limitations

  • GraphQL queries have complexity limits - simplify queries if you hit limits
  • Some column types require specific JSON formats for updates
  • Board and item IDs must be obtained via queries before use in mutations

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
GraphQL
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements