MCP server for AI agents to place real human phone calls (structured answers back) and delegate tasks to human virtual assistants via TaskBullet.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add taskbullet --env TASKBULLET_API_KEY='<TASKBULLET_API_KEY>' --env TASKBULLET_HTTP_TOKEN='<TASKBULLET_HTTP_TOKEN>' -- npx -y @taskbullet/mcp-server~/.codex/config.toml
[mcp_servers.taskbullet]
command = "npx"
args = ["-y", "@taskbullet/mcp-server"]
env = { TASKBULLET_API_KEY = "<TASKBULLET_API_KEY>", TASKBULLET_HTTP_TOKEN = "<TASKBULLET_HTTP_TOKEN>" }
# codex mcp add taskbullet --env TASKBULLET_API_KEY='<TASKBULLET_API_KEY>' --env TASKBULLET_HTTP_TOKEN='<TASKBULLET_HTTP_TOKEN>' -- npx -y @taskbullet/mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"taskbullet": {
"command": "npx",
"args": [
"-y",
"@taskbullet/mcp-server"
],
"env": {
"TASKBULLET_API_KEY": "<TASKBULLET_API_KEY>",
"TASKBULLET_HTTP_TOKEN": "<TASKBULLET_HTTP_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"taskbullet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@taskbullet/mcp-server"
],
"env": {
"TASKBULLET_API_KEY": "<TASKBULLET_API_KEY>",
"TASKBULLET_HTTP_TOKEN": "<TASKBULLET_HTTP_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"taskbullet": {
"command": "npx",
"args": [
"-y",
"@taskbullet/mcp-server"
],
"env": {
"TASKBULLET_API_KEY": "<TASKBULLET_API_KEY>",
"TASKBULLET_HTTP_TOKEN": "<TASKBULLET_HTTP_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"taskbullet": {
"command": "npx",
"args": [
"-y",
"@taskbullet/mcp-server"
],
"env": {
"TASKBULLET_API_KEY": "<TASKBULLET_API_KEY>",
"TASKBULLET_HTTP_TOKEN": "<TASKBULLET_HTTP_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"taskbullet": {
"command": "npx",
"args": [
"-y",
"@taskbullet/mcp-server"
],
"env": {
"TASKBULLET_API_KEY": "<TASKBULLET_API_KEY>",
"TASKBULLET_HTTP_TOKEN": "<TASKBULLET_HTTP_TOKEN>"
}
}
}
}Remote
claude mcp add --transport http taskbullet https://taskbullet.com/api/agent-mcp --header 'x-api-key: <X_API_KEY>'~/.codex/config.toml
[mcp_servers.taskbullet]
url = "https://taskbullet.com/api/agent-mcp"
http_headers = { x-api-key = "<X_API_KEY>" }
# codex mcp add taskbullet --url https://taskbullet.com/api/agent-mcp~/.cursor/mcp.json
{
"mcpServers": {
"taskbullet": {
"url": "https://taskbullet.com/api/agent-mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"taskbullet": {
"type": "http",
"url": "https://taskbullet.com/api/agent-mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"taskbullet": {
"httpUrl": "https://taskbullet.com/api/agent-mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"taskbullet": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://taskbullet.com/api/agent-mcp",
"--header",
"x-api-key:<X_API_KEY>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"taskbullet": {
"url": "https://taskbullet.com/api/agent-mcp",
"headers": {
"x-api-key": "<X_API_KEY>"
}
}
}
}Environment variables
TASKBULLET_API_KEYTASKBULLET_HTTP_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.