Skip to content

taskbullet/taskbullet-agent

v1.2.0MIT

Escalate unfinished agent work to a TaskBullet human virtual assistant, place US and Canada phone calls, and request a human-sent email, through TaskBullet's hosted MCP server. The user supplies their own TaskBullet API key. Nothing runs locally.

TaskBullet Agent plugin for Grok Build

Escalate work a language model cannot finish to a TaskBullet human virtual assistant. This plugin also places US and Canada phone calls and can ask a human to send one email.

The work runs at TaskBullet. Nothing is installed on the user's machine and no code runs locally: the plugin is one MCP server config and three skills.

Install

  1. Install Grok Build and sign in (see the Grok Build docs).

  2. Start grok, run /marketplace, find taskbullet-agent, and install it. Or from a terminal:

    grok plugin install taskbullet-agent --trust
    
  3. Set the plugin variable TASKBULLET_API_KEY to a tb_live_ key from API keys. Grok sends that value as the x-api-key header. The key is not in this repository. Do not paste it into chat.

  4. The hosted server does not advertise OAuth. Do not start an OAuth flow. Follow OAuth only when the server advertises it.

What is in the plugin

ComponentPathPurpose
MCP server.mcp.jsonTaskBullet's hosted server over HTTP
Skillskills/escalate-to-va/SKILL.mdWhen to hand unfinished work to a human VA
Skillskills/place-human-call/SKILL.mdWhen to place one US or Canada phone call
Skillskills/send-human-email/SKILL.mdWhen to ask a human to send one email

There are no hooks, commands, agents, scripts, local binaries, or postinstall steps.

Tools

The plugin connects to the hosted server. tools/list is the live tool list. These are the tools that server documents:

GroupTools
Balanceget_balance
VA tasksdelegate_task, list_tasks, get_task, confirm_task, cancel_task, reopen_task
Phone callsvalidate_call, place_call, get_call, get_call_events, update_call, cancel_call, get_transcript
Human emailvalidate_action, request_action, get_action, update_action, approve_action, cancel_action

delegate_task files a brief and waits for the customer to click Start. It does not dial and it does not send email. A phone call is place_call. An email a human sends is request_action.

Network endpoints and credentials

EndpointWhy
https://taskbullet.com/api/agent-mcpThe only endpoint this plugin calls. Every tool call goes here.

The plugin itself contacts nothing else and sends no telemetry. It does not read ~/.ssh, .env, tokens, or environment variables. The host substitutes the user-configured TASKBULLET_API_KEY into the x-api-key header.

Credentials required: the user's own TaskBullet API key. Header auth is x-api-key: tb_live_…. Authorization: Bearer tb_live_… is also accepted by the server. Unauthenticated requests do not run tools.

Paid actions need an explicit yes for that action's quoted cost or stated hold. Connection consent or a general "send it" is not cost approval.

Links

License

MIT. See LICENSE.