View as Markdown
Microsoft Outlook Calendar icon

Microsoft Outlook Calendar ACTION

Search People

Retrieve a collection of person objects ordered by their relevance to the user, based on communication and collaboration patterns and business relationships. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Outlook Calendar account once, then configure and run Search People from your backend or agent.

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 result = await pd.actions.run({
  id: "microsoft_outlook_calendar-search-people",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_outlook_calendar: { authProvisionId: "apn_xxxxxxx" },
    search: "Search Query",
    filter: "Filter",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search People inputs
Property Type Description
search Search Query string
Search for people by name or alias (e.g., 'Jane Smith'). Supports fuzzy matching. Note: Only works for the signed-in user's relevant people.
Optional
filter Filter string
Filter people using OData syntax. Limits response to people matching specified criteria. See the documentation
Optional
orderBy Order By string
Changes the sort order of results. For example, displayName or displayName desc. Default ordering is by relevance to the user.
Optional
select Select string
Comma-separated list of properties to include in the response. Recommended for performance optimization.
Optional
skip Skip integer
Skip the first N results. Note: Not supported with $search.
Optional
maxResults Max Results integer
The maximum number of people to return per page
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
microsoft_outlook_calendar-search-people
Version
0.0.8
App
Microsoft Outlook Calendar
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes