Less Annoying CRM ACTION
Search Contacts
Searches contacts and companies in Less Annoying CRM by free text (name, email, phone, etc.), with optional filters for record type, owner, and sorting. With no search terms it lists records. Use this to find a
contactId before calling Get Contact, Get Contact Activities, Update Contact, Create Note, Create Task, or Create Pipeline Item. For "my contacts", get the user ID from List Users and pass it in ownerIds. advancedFilters is an optional JSON array of {"Name": field, "Operation": op, "Value": value} objects; see the filter docs for valid operations. Returns results plus hasMoreResults; if true, call again with page incremented. Each result is trimmed to ContactId, IsCompany, Name, Company Name, Job Title, Email, Phone, AssignedTo, and LastUpdate; pass fields (e.g. ["Address", "Background Info"]) to get other fields too, or use Get Contact for the full record. Example: searchTerms: "jane@acme.com" returns {"hasMoreResults": false, "results": [{"ContactId": "1234567890123456789012345678901", "IsCompany": false, "Name": {"FirstName": "Jane", "LastName": "Smith"}, "Email": [{"Text": "jane@acme.com", "Type": "Work"}], ...}]}. See the documentation- Action
- Read only
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Less Annoying CRM account once, then configure and run Search Contacts 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: "less_annoying_crm-search-contacts",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
less_annoying_crm: { authProvisionId: "apn_xxxxxxx" },
searchTerms: "Search Terms",
recordType: "Record Type",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "less_annoying_crm-search-contacts",
"configured_props": {
"less_annoying_crm": { "authProvisionId": "apn_xxxxxxx" },
"searchTerms": "Search Terms",
"recordType": "Record Type"
}
}'// 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": "less_annoying_crm",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "less_annoying_crm-search-contacts",
arguments: {
searchTerms: "Search Terms",
recordType: "Record Type",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
searchTerms Search Terms | string | Text to match against contact/company fields, e.g. Jane Smith or jane@acme.com. Optional |
recordType Record Type | string | Limit results to people or companies, e.g. Companies. Omit for both. Optional |
ownerIds Owner User IDs | string[] | Only return records assigned to these user IDs, e.g. ["1240220"]. Use List Users to find IDs (the UserId field). Optional |
sortBy Sort By | string | Field to sort results by, e.g. LastUpdate. Defaults to Relevance. Optional |
sortDirection Sort Direction | string | Sort order, e.g. Ascending. Defaults to Descending. Optional |
advancedFilters Advanced Filters | string | JSON array of filters, e.g. [{"Name": "DateCreated", "Operation": "GreaterThan", "Value": "2025-01-01"}]. Optional |
fields Extra Fields | string[] | Additional record fields to include beyond the default set, e.g. ["Address", "Background Info", "Website", "DateCreated"]. Custom field names are also accepted. Optional |
maxResults Max Results | integer | Maximum number of results to return per call (e.g. 50; default 50, max 10000). Optional |
page Page | integer | Page of results to return, starting at 1, e.g. 2. Increment while the response has hasMoreResults: true. 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
- less_annoying_crm-search-contacts
- Version
- 0.0.1
- App
- Less Annoying CRM
- Authentication
- API key
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗