Skip to main content
Glama

lemlist_task

Manual tasks assigned to a user (call, LinkedIn touch, follow-up).

A task is a REMINDER for a human: creating one sends nothing.

Args by op:

  • list: page, filters (list of {filterId, …}).

  • create: task_type (email, manual, phone, linkedin), assigned_to (user id), due_date AND record_id (the contact ctc_… or lead lea_… the task hangs off) — all four required, the last one despite lemlist documenting it optional; then title, message, priority (0 high … 2 low), images/videos (public HTTPS URLs).

  • update: task_id + any of title, message, priority, due_date, assigned_to, done, images, videos.

  • ignore: ids — dismiss without completing.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "op": "<op>"
    },
    "name": "lemlist_task"
  }
}

Input Schema

NameRequiredDescriptionDefault
opYes
idsNo
_orgNoOrg (id) de CET APPEL. `oto_list_orgs()`.
doneNo
pageNo
titleNo
_groupNoÉquipe (id) de CET APPEL, sous son org parente.
imagesNo
videosNo
_run_idNoOBLIGATOIRE à chaque appel dès `run_start` ou `data_claim_next` : sans lui, l'écriture sur une ligne réservée est refusée. Hérité seulement si le serveur tient un run actif — n'y compte pas.
filtersNo
messageNo
task_idNo
_projectNoProjet (id) de CET APPEL — jeton PRIMAIRE. `oto_project(op='list')`.
due_dateNo
priorityNo
_instanceNoInstance de connecteur PRÉCISE (un credential exact). `oto_instance(op='list')`.
record_idNo
task_typeNo
assigned_toNo

Schema Changelog

Changes observed during successful MCP inspections.

No schema history has been recorded yet.

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are supplied, so the description carries the full burden and does notable work: it pre-empts the most damaging misunderstanding ('creating one sends nothing'), explains that `ignore` dismisses without completing, and flags a real trap — `record_id` is required here 'despite lemlist documenting it optional'. It stops short of permissions, rate limits, reversibility of `ignore`, and what `list` returns or how pagination behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the one-line definition, then a compact per-op argument list rather than prose. Every clause earns its place — the 'sends nothing' framing, the required-four warning, the priority scale, the URL constraint — and there is no filler or repetition of schema text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single tool multiplexing four operations over 20 parameters with no annotations and no output schema, the definition covers the write semantics and the per-op argument contract thoroughly. The gap is on the read side: nothing describes what `list` returns, its result shape, or how paging across `page` ends, which matters because there is no output schema to fall back on.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 20 parameters and only 25% schema coverage, the description compensates well: it enumerates the required create args ('all four required'), supplies the `task_type` enum (`email`, `manual`, `phone`, `linkedin`) that the schema does not constrain, explains `priority` as `0` high … `2` low, gives the `ctc_…`/`lea_…` format for `record_id`, and restricts media to public HTTPS URLs. The remaining namespace params (`_org`, `_project`, `_instance`, `_run_id`, `_group`) are covered by their own schema descriptions, though `due_date` format and the `filters` object shape stay thin.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a concrete verb+resource (manual tasks assigned to a user: call, LinkedIn touch, follow-up) and immediately disambiguates the object: 'A task is a REMINDER for a human: creating one sends nothing.' That single line separates it from the outreach-oriented siblings like lemlist_sequence, lemlist_launch_lead and lemlist_schedule without needing to open a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description organizes the tool into four ops (list/create/update/ignore) and names the arguments each op consumes, so the agent knows which op to pick for a given intent, and 'ignore' is explicitly defined as dismissing without completing versus 'update' with `done`. What's missing is any explicit routing to alternatives (e.g., when to use this task tool rather than lemlist_sequence or lemlist_schedule), so there is clear context but no exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources