Zum Inhalt
Für Agenten

MCP Reference

email_convert_to_task

Convert Email to Task

Markdown Tools als JSON

Beschreibung

Creates a Task from an email and links the two so the conversion is traceable and idempotent.

Pass exactly one of message_id (emsg_…) or thread_id (ethr_…); for a thread the latest message is used as the anchor. workspace_id is the destination workspace (prefix wsp_… or KEY like ENG); project_id (proj_… or slug) is optional and must belong to that workspace.

Defaults: title = the email subject; the task description is seeded from the email body (override with description, Markdown). assignee is a @handle or user prefix.

link_kind is created_from (default — this task was made from the email) or referenced_in. Idempotent: if the source is already linked with the same link_kind, the existing task is returned with created: false and no new task is made.

Zugriff

Zugriffsprofil: gated. Module: email. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja Account prefix ID (acct_…).
message_id string Nein Source message (emsg_…). Provide this OR thread_id.
thread_id string Nein Source thread (ethr_…); its latest message is used. Provide this OR message_id.
workspace_id string Ja Destination workspace prefix ID (wsp_…) or KEY (e.g. ENG).
project_id string Nein Optional project (proj_… or slug); must belong to the workspace.
title string Nein Task title. Defaults to the email subject.
description string Nein Task description in Markdown. Defaults to the email body.
assignee string Nein Assignee @handle or user prefix ID.
link_kind string Nein Provenance link kind. Default created_from.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID (acct_…)."
    },
    "message_id": {
      "type": "string",
      "description": "Source message (emsg_…). Provide this OR thread_id."
    },
    "thread_id": {
      "type": "string",
      "description": "Source thread (ethr_…); its latest message is used. Provide this OR message_id."
    },
    "workspace_id": {
      "type": "string",
      "description": "Destination workspace prefix ID (wsp_…) or KEY (e.g. ENG)."
    },
    "project_id": {
      "type": "string",
      "description": "Optional project (proj_… or slug); must belong to the workspace."
    },
    "title": {
      "type": "string",
      "description": "Task title. Defaults to the email subject."
    },
    "description": {
      "type": "string",
      "description": "Task description in Markdown. Defaults to the email body."
    },
    "assignee": {
      "type": "string",
      "description": "Assignee @handle or user prefix ID."
    },
    "link_kind": {
      "type": "string",
      "enum": [
        "created_from",
        "referenced_in"
      ],
      "description": "Provenance link kind. Default created_from."
    }
  },
  "required": [
    "account_id",
    "workspace_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "key": {
          "type": "string"
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "key",
        "url"
      ]
    },
    "link": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "kind"
      ]
    },
    "created": {
      "type": "boolean",
      "description": "false when an existing link/task was returned (idempotent)."
    }
  },
  "required": [
    "task",
    "link",
    "created"
  ],
  "type": "object"
}
Seiten