# Monday.com MCP > Monday.com MCP Server connects your AI client to your entire Work OS. It lets you manage projects, assign tasks, and read team data without logging into the dashboard. Your agent can list all boards in a workspace, create new items, update specific column values, or post comments—all through natural language conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** task-management, workflow-automation, team-collaboration, board-management, resource-planning, work-os ## Description Your agent handles everything in **Monday.com**, letting you manage your entire Work OS straight from chat. You don't gotta log into the dashboard; just talk to your client and get things done. **Discovering Your Workspace Structure** You can start by listing all your main containers, which are the `list_workspaces` umbrella projects. From there, you'll see every available board using `list_boards`. For any single board, your agent gets the names of all organizational sections with `list_board_groups`. To know what data points a board uses, run `get_board_schema`, and it’ll pull back the exact column names and their types. You can list every row (task) on a specific board using `list_board_items`. **Managing Tasks (Items)** When you need to make changes, your agent handles the whole lifecycle. To get started, you'll use `create_new_item`, telling it which board to add the task to and what initial column values should be set. Need to change something later? You modify existing data using `update_item_columns` by specifying which columns need new values for a given item. If an entire row is dead weight, you can trash it completely with `remove_item`. **Communication and Tracking Updates** You keep everyone in the loop through updates. You can post a fresh comment or status update to any task using `post_item_update` for instant transparency. If you gotta check what happened last week, your agent retrieves the full history of comments and changes made on that item via `list_item_updates`. **Getting Core System Data** Your client also gives you visibility into who's working on what. It pulls basic details about your connected account using `get_my_profile`, and it can list every teammate in the workspace, fetching all profiles with `list_account_users`. ## Tools ### create_new_item Adds a new row (task) to a specific board, allowing you to define initial column values. ### post_item_update Adds a new comment or status update to an existing task item's feed. ### remove_item Deletes an entire row (task) from the board, removing it from circulation. ### get_board_schema Retrieves the names and types of all columns available on a selected board. ### get_my_profile Fetches basic information about the connected Monday.com user account. ### list_boards Retrieves an overview of every available board in your workspace. ### list_board_groups Retrieves the names of sections or groups that organize items on a board. ### list_board_items Lists all rows (tasks) belonging to a specific Monday.com board. ### list_item_updates Gets a chronological list of all comments and updates made to a specific task item. ### list_account_users Lists all team members and their associated profiles within your workspace. ### list_workspaces Lists the main container or umbrella projects within your overall Monday.com account. ### update_item_columns Modifies one or more specific values within a task item's columns. ## Prompt Examples **Prompt:** ``` List all active Monday.com boards in my workspace. ``` **Response:** ``` I've retrieved your boards. You have 3 active environments: 'Q4 Product Roadmap', 'Team Tasks', and 'Marketing Launch'. Which one would you like to see items for? ``` **Prompt:** ``` Create a new task 'Finalize SEO Audit' in the 'Marketing Launch' board. ``` **Response:** ``` Task created! I've added 'Finalize SEO Audit' to the Marketing Launch board. Would you like me to assign it to someone or add an initial comment? ``` **Prompt:** ``` Show the latest updates for the 'Acme Corp' item. ``` **Response:** ``` I've retrieved the updates. The last comment was from Robert Chen: 'Waiting for client approval on the design specs' (2 hours ago). ``` ## Capabilities ### Discover Boards and Structure List all boards, workspaces, or groups within your Monday.com account. ### Manage Tasks (Items) Create new tasks on a board; update existing task columns; or delete entire items. ### Communicate Updates Add comments to specific items, or retrieve the full history of updates for a task. ### Analyze Metadata Fetch schema details (column types) for a board, or list all team members and user profiles. ## Use Cases ### The Status Check A Project Manager needs to know if the 'Marketing Launch' task is approved. Instead of navigating to the board, they prompt their agent: 'Show the latest updates for the Marketing Launch item.' The agent runs `list_item_updates` and reports the final comment directly in chat. ### New Task Creation An Operations Coordinator is told to create three new tasks. They prompt: 'Create a task for SEO Audit, assign it to John, and set the status column to 'To Do'.' The agent uses `create_new_item` and handles all necessary data mapping. ### Board Discovery A new team member starts and needs to know what projects are active. They ask: 'What boards do we use for Q4 planning?' The agent runs `list_boards`, providing a clean, actionable list of environments. ### Data Correction A developer realizes the wrong date was entered into a task. Instead of opening the board editor, they prompt: 'Update the deadline column for Item XYZ to 2024-12-31.' The agent runs `update_item_columns` safely. ## Benefits - Stop switching apps to check status. Use `list_board_items` or `get_board_schema` to pull live project data directly into the conversation. - Assign work instantly. The `create_new_item` tool lets you generate a task and define its initial column values without opening Monday.com. - Keep communication centralized. Use `post_item_update` to add comments or status changes to a task right from your agent, keeping the record clean. - Track history accurately. If you need context, run `list_item_updates` to pull the full comment thread for any item, instantly. - Manage team structure easily. Run `list_account_users` whenever you need to know who's on a board or what roles are available. ## How It Works The bottom line is, you use your agent like a dedicated operations assistant that talks directly to Monday.com's backend. 1. Subscribe to the MCP Server and generate an API token. 2. Input your Monday.com API Token into the server configuration. 3. Ask your AI client (e.g., 'List all active project boards') to begin managing data. ## Frequently Asked Questions **How do I use the list_boards tool with Monday.com MCP Server?** Simply ask your agent to 'list all boards in my workspace.' The server runs `list_boards` and returns a categorized list of every available environment, which is necessary before targeting any specific tasks. **Can I use create_new_item for multiple projects?** You must specify the target board ID or name. The `create_new_item` tool only adds a row to one defined location at a time, so you'll need to issue separate commands for different boards. **What is the difference between list_board_items and list_workspaces?** The difference is scope. `list_workspaces` shows your highest-level project containers, while `list_board_items` gets you to the specific rows (tasks) within a single board. **Does post_item_update log who added the comment?** Yes. The update mechanism tracks authorship and timestamps. When using `post_item_update`, you're adding a comment that is logged alongside other user contributions to maintain project history. **Before I run `update_item_columns`, how do I confirm what data type a column needs to be?** You must run the `get_board_schema` tool first. This function returns all board metadata, showing you exactly whether a column expects text, numbers, or dates. Always check the schema before attempting an update. **If I use `remove_item`, is there any way to undo the deletion of a board row?** No, removing an item via this tool is permanent and cannot be recovered through the API. Always verify the specific Item ID before running `remove_item` on critical data. **What happens if I run `list_item_updates` for a highly active board?** High volumes of read requests can hit API rate limits. If you need history across many items, you should consider batching your reads or checking the specific usage quota documentation. **How does `get_my_profile` behave if I'm trying to check another user’s information?** It uses the API token owner's context by default. To get details for a different team member, you need to pass that specific user ID into the function call. **Can my AI automatically find the details for a specific item by its ID?** Yes! Use the `get_item_details` tool (via queries). Your agent will respond with complete metadata for the record, including column values and update history in seconds. **How do I find my Monday.com API Token?** Log in to your Monday.com account, click on your **Avatar** (bottom left), navigate to **Developers**, and you will find your unique secret token under the API section. **Does this work with private boards?** Yes, provided the API token used has the necessary permissions and access to those boards within your Monday.com workspace.