The Platform MCP added a batch of new tools across recent releases — all live on the hosted server (https://mcp.monday.com/mcp) and now documented in the Platform MCP tools reference. Each entry below links to its tool page and lists the date the tool first shipped (renamed tools also note the original name and rename date).
The GraphQL User type and Query.users are updated across two API versions:
2026-07: New fields, types, enums, Query.users arguments, the user_configs query, and stricter pagination on users.
2026-10: Legacy fields on User are planned for removal. Treat removal timing as subject to the published API schema for your version; migrate off legacy fields as soon as you target 2026-07 or later.
If you only use User.id, User.email, User.name, and User.kind, you do not need changes for those fields. If you use photo URL fields, kind/status booleans, is_verified, join_date, or the old users(kind: …, newest_first: …, non_active: …) arguments, review the sections below.
For step-by-step migration examples, follow the User and users sections in the monday.com API reference for the API version you target.
Changes in 2026-07
New User fields
Field
Type
Description
account_id
ID!
Account the user belongs to.
status
UserStatus!
Activation status: ACTIVE, INACTIVE, or PENDING.
invitation_method
InvitationMethod!
How the user was added to the account.
serial_number
Int
Sequence number for the user within the account.
is_deleted
Boolean!
Whether the user has been soft-deleted.
photo_url
PhotoUrl
Nested object with photo URLs per size. Replaces flat photo_* fields.
became_active_at
ISO8601DateTime
When the user became active. Replaces join_date.
bb_visitor_id
ID!
Opaque platform identifier for the user (stable within the account).
is_email_confirmed
Boolean!
Whether the user confirmed their email. Replaces is_verified.
Allowed values follow API documentation; omit until your integration is aligned with documented values.
Deprecated Query.users arguments (2026-07)
kind, newest_first, and non_active are deprecated on Query.users starting in 2026-07 and marked with @deprecated in the schema. They still work at runtime in 2026-07 and 2026-10, but clients that introspect with includeDeprecated: true will see the deprecation reasons below:
Argument
Deprecation reason
kind
Use user_kind instead.
newest_first
Use sort instead.
non_active
Use status instead.
Update integrations and codegen to the new arguments above. A removal version has not been announced; monitor the release notes for the version your integration targets.
In some preview builds these fields may still appear in introspection or return data until removal is fully rolled out. Do not rely on them for new work; use the replacements below.
Deprecated fields → replacements
Deprecated on User
Replacement
photo_original
photo_url.original
photo_small
photo_url.small
photo_thumb
photo_url.thumb
photo_thumb_small
photo_url.thumb_small
photo_tiny
photo_url.tiny
is_guest
kind == "guest"
is_admin
kind == "admin"
is_view_only
kind == "view_only"
is_pending
status == PENDING
enabled
status == ACTIVE (or != INACTIVE as appropriate)
is_verified
is_email_confirmed
join_date
became_active_at
encrypt_api_token
Removed — no replacement.
sign_up_product_kind
Removed — no replacement.
Deprecated on Query.users
Replacement
kind: UserKind
user_kind: UserKindFilterInput
newest_first: Boolean
sort: [UsersSortInput!]
non_active: Boolean
status: [UserStatus!]
Further reading
monday.com API documentation — versioning, authentication, and reference for User, Query.users, and related types.
API release notes and changelog on the developer site for the exact behavior of each API-Version you call.
You can now query a user's activity log events directly from the users query. The new activity_logs field returns a paginated list of events with cursor-based pagination, filterable by board and event type.
Query
users { activity_logs } — retrieve a user's activity log events as a UserActivityLogsPage with cursor pagination
query {
users(ids: [1234567890]) {
id
activity_logs(
from: "2026-03-01T00:00:00Z"
to: "2026-04-09T23:59:59Z"
limit: 50
) {
cursor
logs {
id
event
entity
data
user_id
created_at
}
}
}
}
You can now create, query, and delete relations between objects via the API. Relations can represent aliases or dependencies between boards and dashboards.
Query
object_relations — retrieve relations for an object, filterable by kind (ALIAS or DEPENDENCY) and direction (OUTGOING or INCOMING)
You can now retrieve notetaker meeting data via the API using the new notetaker.meetings query. This returns paginated meetings with completed recordings that the current user can view, including summaries, topics, action items, transcripts, and participants.
You can now search your account's knowledge base via the API using the knowledge_base_search query. It performs an AI-powered search across knowledge base snippets and returns an LLM-generated answer along with the raw source snippets.
query {
knowledge_base_search(query: "What is our refund policy?", limit: 5) {
answer
raw_snippets {
id
title
text
url
distance
}
}
}
You can now retrieve a document's version history and compare changes between versions using two new queries: doc_version_history and doc_version_diff.
doc_version_history
Returns restoring points (snapshots) for a document, grouped in 5-minute intervals. You can optionally filter by date range using ISO 8601 timestamps.
query {
doc_version_history(
doc_id: "123456"
since: "2026-03-01T00:00:00Z"
until: "2026-03-31T23:59:59Z"
) {
doc_id
restoring_points {
date
user_ids
type
}
}
}
doc_version_diff
Returns the blocks that were added, deleted, or changed between two restoring points.
The BlockEvent type now includes fields to support automation loops (iterators). These fields let you identify whether a block event is part of a loop and track its progress.
Field
Type
Description
iterator_id
ID
The iterator identifier if the block is part of a loop