How do I use monday-api-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@monday-api-mcp Show my boards" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

monday-api-mcp

by lalitsonawane

Overview Schema Source Related Servers Discussions Admin

Local

Local monday.com Platform MCP (IBM Bob)

Natural-language monday.com task management via the official Platform MCP package @mondaydotcomorg/monday-api-mcp, running locally on this Mac and wired into IBM Bob.

Auth decision

Path	Status
Hosted MCP + OAuth (`https://mcp.monday.com/mcp`)	Supported by monday; not used here (not local)
Local MCP + OAuth	Not supported by the official local server
Local MCP + personal API token	Implemented

Token is loaded from macOS Keychain (monday-api-token) or ~/.bob/monday.env (mode 600). Nothing secret is committed.

Related MCP server: Linear MCP

Prerequisites

Node.js 20+ (this machine: Node 22)
npm
monday.com personal API token (Developers → My access tokens)

cd /Users/lalit/Developments/bob-mcp-monday-v3.0
npm install
./scripts/store-monday-token.sh   # or: MONDAY_TOKEN='...' ./scripts/store-monday-token.sh

IBM Bob MCP configuration (reference)

Official docs: Using MCP in Bob · Bob Shell MCP · Server transports

Config file locations

Bob supports two MCP config levels. Project overrides global when the same server name appears in both.

Level	Path on this machine	Scope
Global (Bob IDE)	`/Users/lalit/.bob/mcp.json`	All workspaces
Project	`/Users/lalit/Developments/bob-mcp-monday-v3.0/.bob/mcp.json`	This repo only (can be shared via git; no secrets)
Bob Shell / settings sync	`/Users/lalit/.bob/settings/mcp_settings.json`	Kept in sync with the same `monday-api-mcp` entry for Shell

Related (not Bob MCP JSON, but used by our launcher):

File	Role
`scripts/monday-mcp.sh`	STDIO entrypoint Bob runs (`command`)
`/Users/lalit/.bob/monday.env`	Token fallback (`chmod 600`) — never commit
macOS Keychain service `monday-api-token`	Preferred token store

Edit config from Bob UI

Open the Bob panel → settings (gear) → MCP tab.
Edit Global MCP → opens ~/.bob/mcp.json.
Edit Project MCP → opens .bob/mcp.json in the project root (created if missing).
Ensure Use MCP Servers is checked.
Expand monday-api-mcp to enable/disable individual tools if you want a smaller tool set.

After JSON edits: reload MCP or restart Bob so the server reconnects.

Active server entry (copy/paste)

Transport: STDIO (local process). Format matches Bob’s mcpServers schema (command, args, disabled; optional cwd, env, alwaysAllow).

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "/Users/lalit/Developments/bob-mcp-monday-v3.0/scripts/monday-mcp.sh",
      "args": ["--enable-dynamic-api-tools", "true"],
      "disabled": false
    }
  }
}

Field	Value / notes
Server name	`monday-api-mcp` (shown in Bob MCP tab)
`command`	Absolute path to the Keychain-backed launcher
`args`	Full CRUD + `all_monday_api` escape hatch
Read-only mode	Use `"args": ["--read-only"]` instead (cannot combine with dynamic API tools)
`disabled`	`true` to stop Bob from spawning the server

Token is not in the JSON — the launcher loads MONDAY_TOKEN from Keychain / ~/.bob/monday.env.

Start / stop in Bob

There is no long-running daemon. Bob spawns the STDIO server when MCP is enabled.

Bob panel → MCP → Use MCP Servers = on.
Confirm monday-api-mcp is listed and not disabled.
After config or token changes: restart Bob or toggle MCP off/on.
To stop: uncheck Use MCP Servers, set "disabled": true, or remove the server entry.

Smoke test without Bob:

./scripts/verify-mcp.sh --enable-dynamic-api-tools true get_user_context '{}'

Create / rotate credentials

monday avatar (bottom-left) → Developers → My access tokens → copy token.
Store securely:

./scripts/store-monday-token.sh
# or non-interactive:
MONDAY_TOKEN='paste_token_here' ./scripts/store-monday-token.sh

This updates Keychain service monday-api-token and ~/.bob/monday.env.

Rotate: generate a new token in monday, re-run the store script, then reload Bob MCP. Revoke the old token in monday.

Example natural-language commands

“Who am I in monday?”
“Show my boards”
“Show schema for board project-tasks-update (columns and groups)”
“Create a task on that board in group Y with status Working on it, due Friday”
“Move item Z to Done and assign it to me”
“List overdue items on the Marketing board”
“Add a comment on item …”
“Archive/delete this item” (assistant must confirm first)

See assistant-instructions.md for tool-mapping and safety rules.

Capability checklist

Area	Tools
READ	`get_user_context`, `list_workspaces`, `search`, `get_board_info`, `get_board_schema`, `get_board_items_page`, `get_updates`, `list_users_and_teams`, …
CREATE	`create_board`, `create_group`, `create_item`, `create_update`, column values via create/change tools
UPDATE	`change_item_column_values`, `move_item_to_group`, item name via API tools
DELETE	`delete_item`, `delete_update` (confirm first); archive via dedicated tool or `all_monday_api`
Escape hatch	`all_monday_api`, `get_graphql_schema`, `get_type_details`

Apps MCP (--mode apps) is not enabled — Platform workspace data only.

Troubleshooting

Symptom	Fix
Bob doesn’t show `monday-api-mcp`	Check `/Users/lalit/.bob/mcp.json` and project `.bob/mcp.json`; Bob panel → MCP → Use MCP Servers on; restart Bob
Editing the wrong file	IDE global = `~/.bob/mcp.json`; project override = `.bob/mcp.json`; Shell also reads `~/.bob/settings/mcp_settings.json`
Project config ignored	Project entry wins only when this workspace is open; otherwise global applies
Auth / 401 / “not authenticated”	Re-run `./scripts/store-monday-token.sh` with a fresh token; reload Bob
Server won’t start	`npm install` in this repo; confirm `node_modules/@mondaydotcomorg/monday-api-mcp/dist/index.js` exists; `command` path must be absolute
Missing tools	Ensure args include `--enable-dynamic-api-tools true` (not `--read-only`); reload Bob; check per-tool toggles in Bob MCP tab
Rate limits	MCP calls count toward monday’s daily API limit — batch reads, avoid tight loops
Permission denied on a board	Token only sees boards your user can access; ask a board owner for access
Hosted OAuth preferred later	In Bob MCP JSON use streamable HTTP: `"type": "streamable-http", "url": "https://mcp.monday.com/mcp"` (see Bob transport docs); may require monday AI Connectors / marketplace MCP app
Disk full / npx slow	Prefer local `npm install` (wrapper already uses local `dist/index.js` when present)

Scripts

Script	Purpose
`scripts/monday-mcp.sh`	Bob MCP command entrypoint
`scripts/store-monday-token.sh`	Save token to Keychain + `~/.bob/monday.env`
`scripts/verify-mcp.sh`	Stdio initialize + `tools/list` + optional `tools/call`
`scripts/run-acceptance-tests.sh`	Full CRUD acceptance suite

Latest verified run: ACCEPTANCE_RESULTS.md (all 8 checks passed).

References

IBM Bob

Using MCP in Bob — global ~/.bob/mcp.json vs project .bob/mcp.json
Bob Shell MCP
MCP server transports — STDIO vs streamable HTTP

monday.com

Package: @mondaydotcomorg/monday-api-mcp
Repo: https://github.com/mondaycom/mcp
Hosted MCP: https://mcp.monday.com/mcp
Platform MCP overview: https://developer.monday.com/api-reference/docs/monday-mcp-overview# bob-mcp-monday-v3.0

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

KodyOAuth
io.github.kentcdodds
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Developer Tools Code Execution Command Line
2681
Monday A
io.github.pipeworx-io
Monday.com MCP — wraps the Monday.com GraphQL API (BYO API key)
Project Management Workplace & Productivity App Automation
2
mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
mcpOAuth
net.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
App Automation Workplace & Productivity Project Management
2

Related MCP Servers

notion-mcp
Note Taking Project Management
bramleyjl
F
license
Not graded
quality
B
maintenance
Personal Notion MCP server with tools for task management, wrapping the Notion REST API to create, query, and update tasks in a kanban board.
Updated a month ago (2026-08-25 01:42 UTC)
-
Linear MCP
Project Management Developer Tools
jonasgantner
A
license
Not graded
quality
B
maintenance
Custom MCP server for Linear that enables managing issues, projects, and workspaces through natural language, backed by raw GraphQL.
Updated 5 days ago (2026-09-25 14:21 UTC)
276 npm
MIT
mcp-boards-nk
Project Management Workplace & Productivity
nikodev-documentacion
A
license
A
quality
D
maintenance
MCP server for Mattermost Boards (Focalboard) that enables natural language management of teams, boards, and cards, including CRUD operations.
Updated 3 months ago (2026-06-24 01:52 UTC)
11
17 npm
MIT
task-manager-mcp
Project Management Developer Tools
doberoi21
F
license
Not graded
quality
D
maintenance
A task manager MCP server that demonstrates all three MCP primitives (tools, resources, prompts). Enables users to manage tasks, read task summaries and details, and run structured planning/review prompts through natural language.
Updated 3 months ago (2026-06-23 20:17 UTC)
-