MULTI-APP TOOLKIT
Build with Intercom + monday
- Multi-app
- One MCP session
- 31 actions
- 26 triggers
- Managed auth
MCP
One MCP session, both toolsets
One session gives your product or agent every Intercom and monday tool at once — connect once, list tools, and call them like any single-app session.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "intercom,monday",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// One list, both toolsets: Intercom and monday tools arrive
// together, each keyed by its own app's slug.
// e.g. run Add Tag To Contact:
const result = await mcp.callTool({
name: "intercom-add-tag-to-contact",
arguments: {
contactId: "Contact ID",
tagId: "Tag ID",
},
})import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const externalUserId = "{external_user_id}" // any stable ID for this user in your system
const [intercomTools, mondayTools] =
await Promise.all([
pd.components.list({ app: "intercom" }),
pd.components.list({ app: "monday" }),
])
// One external user owns both connected accounts, so either app's tools
// run on their behalf with the same externalUserId.curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=intercom" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}"
curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=monday" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}"
# Connect both accounts to the same external_user_id, then
# configure and invoke either app's tools on that user's behalf.ARCHITECTURE
One user, two connected accounts
Your user connects each account once, under whatever ID they already have in your product. The two stay independent — either can be revoked on its own — and your code reaches both through that one user.
Your product
external_user_id
{external_user_id}Pipedream Connect
Managed identity
Auth · tools · routing
Intercom
Connected account
monday
Connected account
TOOLS
Intercom tools
The Intercom tools this pairing puts in reach, each one running on your user's own connected account.
Actions top 8 of 13
-
Add Tag To Contact
actionAdds a specific tag to a contact in Intercom. Use Search Contacts to find the contact's ID and List Tag ID Options to find valid tag IDs before calling this action. Example: set Contact ID to63a07ddf05a32042dffac965and Tag ID to7522907to tag that contact. Returns the updated tag object on success. See the documentation.Writev0.0.5 -
Create Note
actionCreates a note on a contact's record in Intercom. The note is automatically attributed to the currently authenticated admin — no Admin ID prop is required. Use Search Contacts to find the contact's ID before calling this action. Example: set User to63a07ddf05a32042dffac965and Body toFollowed up via email on 2024-01-15to log a note on that contact. Returns the new note object includingid,body, andauthor. See the documentationWritev0.0.9 -
List Admin ID Options
actionRetrieves all admins in your Intercom workspace and returns their IDs and names. Call this action before any action that requires an Admin ID — such as Manage A Conversation, Reply To Conversation, or Send Message To Contact — to discover valid values. Example: returns[{ label: "Jane Doe", value: "25" }, ...]. See the documentation.Read-onlyv0.0.3 -
List Assignee ID Options
actionRetrieves all teams in your Intercom workspace and returns their IDs and names. Call this action before Manage A Conversation to discover valid team IDs for conversation assignment. Example: returns[{ label: "Support", value: "334" }, ...]. Use0to represent Unassigned. See the documentation.Read-onlyv0.0.3 -
List Conversations
actionLists conversations in your Intercom workspace, most recently updated first (GET /conversations). Use this to discover a conversation's ID before calling Reply To Conversation, Manage A Conversation, or Retrieve Conversation — there is no other way to look one up. Returns a bounded page of conversations, each includingid,state,created_at, and the latest message part. Ifpages.next.starting_afteris present in the response, call this action again with that cursor in Starting After to retrieve the next page. Pass Fields (e.g.["id", "state", "created_at"]) to limit each returned conversation to only those keys. Example: leave all props empty to fetch the 20 most recently updated conversations. See the documentation.Read-onlyv0.0.2 -
List Tag ID Options
actionRetrieves all tags in your Intercom workspace and returns their IDs and names. Call this action before Add Tag To Contact to discover valid tag IDs. Example: returns[{ label: "VIP", value: "7522907" }, ...]. See the documentation.Read-onlyv0.0.3 -
Manage A Conversation
actionClose, snooze, open, or assign a conversation by its ID. Which of the optional props apply depends on Message Type:closeuses Body,snoozeduses Snoozed Until,assignmentuses Type together with Assignee ID or Team Assignee ID, andopenuses none of them. Example: set Conversation ID to192783634529321, Message Type toclose, and Body toIssue resolvedto close that conversation with a closing comment. See the documentation.Writev0.1.2 -
Reply To Conversation
actionReply to an existing Intercom conversation as an admin or on behalf of a contact (POST /conversations/{conversation_id}/reply). Use List Admin ID Options to find a valid Admin ID, and Search Contacts to find a contact's Intercom user ID, email, or external user ID. Example: set Conversation ID to192783634529321, Reply Type toadmin, Message Type tocomment, Body toThanks for reaching out!, and Admin ID to25to post that comment as an admin reply. See the documentation.Writev0.1.1
Triggers top 4 of 16
-
New Companies
triggerEmit new event each time a new company is added.v0.0.9 -
New Reply From Admin
triggerEmit new event each time an admin replies to a conversation.v0.0.9 -
New Conversations
triggerEmit new event each time a new conversation is added.v0.0.9 -
New Reply From User
triggerEmit new event each time a user replies to a conversation.v0.0.9
TOOLS
monday tools
The monday tools this pairing puts in reach, each one running on your user's own connected account.
Actions top 8 of 18
-
Create an Update
actionPost an update (a comment) on an item, or reply to an existing update. Use to add a note to an item's activity feed; this changes no column value — use Update Column Values for that. SetBoard ID,Item IDandUpdate Body, and setParent Update IDonly when replying to an existing update rather than starting a new thread. Example: Update BodyDesign approved, moving to build. Returns the new update's ID as a string. Use Get Board Items Page to find anItem ID. See the documentationWritev0.0.19 -
Create Board
actionCreate a new board in a workspace. Use when you need a new board before adding groups, columns or items to it. SetBoard NameandBoard Kind(public,privateorshare); if you omitWorkspace IDthe board is created in the Main Workspace. Example: Board NameQ3 Campaigns, Board Kindpublic. Returns the new board's ID as a string (e.g.2419687965), not the full board object — call List Boards if you need its details. Use List Workspace ID Options to find a validWorkspace ID. See the documentationWritev0.0.16 -
Create Column
actionAdd a column to an existing board. Use when a board is missing a field you need before setting values with Create Item or Update Column Values. SetBoard ID,TitleandColumn Type(e.g.status,text,date,numbers).Custom Labels (Defaults)is accepted only whenColumn Typeisstatusordropdownand is rejected for any other type. Example: TitlePriority, Column Typestatus, Custom Labels{ "1": "High", "2": "Low" }. Returns the new column's ID as a string (e.g.status_1). Call List Columns afterwards to confirm the ID and the labels it accepts. See the documentationWritev0.1.8 -
Create Group
actionCreate a group (a titled section of rows) on a board. Use when you need somewhere to put new rows before calling Create Item, which takes an optionalGroup ID. SetBoard IDandGroup Name. Example: Board ID2419687965, Group NameIn Progress. Returns the new group's ID as a string (e.g.new_group12345) — pass that value asGroup IDto Create Item. Use List Board ID Options to find a validBoard ID. See the documentationWritev0.0.17 -
Create Item
actionCreate an item (a row) on a board. Use for a top-level row; use Create Subitem for a row nested under an existing item. SetBoard IDandItem Name, and optionallyGroup IDandColumn Values. Call List Columns first to get the column IDs and the labels astatusordropdowncolumn accepts. Example: Item NameWebsite redesign, Column Values{ "status": "Working on it", "date4": "2026-09-02", "numbers": 42 }. SetItem Create Labelstotrueto allow missingstatus/dropdownlabels to be created, which requires permission to change the board structure. Returns the new item's ID as a string (e.g.9876543210). See the documentationWritev0.1.9 -
Create Subitem
actionCreate a subitem nested under an existing item. Use when the row belongs to a parent item; use Create Item for a top-level row. SetBoard ID(the parent item's board),Parent Item IDandItem Name. Gotcha: subitems live on a separate subitems board, soColumn Valuesmust use that board's column IDs — run List Columns against the subitems board, not the board selected here. Example: Item NameDraft copy, Column Values{ "status": "Done" }. Returns the new subitem's ID as a string. See the documentationWritev0.1.9 -
Get Board Items Page
actionList every item (row) on a board, following the API's cursor automatically so all pages are returned in a single call — you do not need to paginate. Use when you want the whole board; use Get Items By Column Value to filter server-side by one column, which is far cheaper on a large board. SetBoard ID, and optionallyQuery Paramsto filter or sort. Example: Query Params{ "rules": [{ "column_id": "status", "compare_value": ["Done"], "operator": "any_of" }] }. Returns an array of items withid,name,state, timestamps and column values. Gotcha: a large board returns every row in one response, so expect a slow call and a large payload. See the documentationRead-onlyv0.0.7 -
Get Column Values
actionRead the column values of one item. Use when you already have anItem IDand want its field values; use Get Items By Column Value to search for items by a value instead. SetBoard IDandItem ID; leaveColumn IDsempty to return every column, or pass specific column IDs from List Columns. Example: Item ID9876543210, Column IDs["status", "date4"]. Returns an array holding the item and acolumn_valuesarray of{ id, value }pairs, wherevalueis the column's display text when one exists and the raw JSON value otherwise. See the documentationRead-onlyv0.0.14
Triggers top 4 of 10
-
Column Value Updated (Instant)
triggerEmit new event when a column value is updated on a board. See the documentationInstantv0.0.15 -
Name Updated (Instant)
triggerEmit new event when an item's name is updated. See the documentationInstantv0.0.15 -
New Board Created
triggerEmit new event when a board is created in Monday. See the documentationv0.0.16 -
New Item Created (Instant)
triggerEmit new event when a new item is added to a board. See the documentationInstantv0.0.15
MULTI-APP
Works with more apps
The combinations customers connect alongside these two — nothing here is limited to a pair.
REFERENCE
Toolkit details
- x-pd-app-slug
- intercom,monday
- Primary app
- Intercom (intercom)
- Second app
- monday (monday)
- Authentication
- OAuth + API key
- Available actions
- 31
- Available triggers
- 26