# Search Contacts — Less Annoying CRM

> 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…

- Key: `less_annoying_crm-search-contacts`
- Type: Action (Read-only)
- Version: 0.0.1
- App: Less Annoying CRM (`less_annoying_crm`) — https://pipedream.com/apps/less-annoying-crm.md
- This page (HTML): https://pipedream.com/apps/less-annoying-crm/actions/search-contacts
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/less_annoying_crm/actions/search-contacts/search-contacts.mjs

## Description

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](https://account.lessannoyingcrm.com/api_docs/v2/Advanced/Filter_Contacts) 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](https://account.lessannoyingcrm.com/api_docs/v2/Core_Functions/Contacts#Goto-GetContacts)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `searchTerms` | `string` | No | Text to match against contact/company fields, e.g. Jane Smith or jane@acme.com. |
| `recordType` | `string` | No | Limit results to people or companies, e.g. Companies. Omit for both. |
| `ownerIds` | `string[]` | No | Only return records assigned to these user IDs, e.g. ["1240220"]. Use List Users to find IDs (the UserId field). |
| `sortBy` | `string` | No | Field to sort results by, e.g. LastUpdate. Defaults to Relevance. |
| `sortDirection` | `string` | No | Sort order, e.g. Ascending. Defaults to Descending. |
| `advancedFilters` | `string` | No | JSON array of filters, e.g. [{"Name": "DateCreated", "Operation": "GreaterThan", "Value": "2025-01-01"}]. |
| `fields` | `string[]` | No | Additional record fields to include beyond the default set, e.g. ["Address", "Background Info", "Website", "DateCreated"]. Custom field names are also accepted. |
| `maxResults` | `integer` | No | Maximum number of results to return per call (e.g. 50; default 50, max 10000). |
| `page` | `integer` | No | Page of results to return, starting at 1, e.g. 2. Increment while the response has hasMoreResults: true. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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",
  },
})
```

**TypeScript**

```ts
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**

```bash
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"
    }
  }'
```

---

- App: https://pipedream.com/apps/less-annoying-crm.md · All apps: https://pipedream.com/apps
