← Back to Skills Marketplace
Follow Up Boss
by
danielfoch
· GitHub ↗
· v1.0.0
820
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install follow-up-boss
Description
Command-line tool to manage contacts, tasks, notes, deals, events, and communications via the Follow Up Boss API.
README (SKILL.md)
Follow Up Boss (CLI)
CLI for interacting with the Follow Up Boss API.
Setup
-
Get API Key: Follow Up Boss → Admin → API → Create API Key
-
Set Environment Variable:
export FUB_API_KEY="fka_xxxxxxxxxxxx"
CLI Usage
node fub.js \x3Ccommand> [options]
Commands
| Command | Description |
|---|---|
me |
Current user info |
people [query] |
List/search people |
person \x3Cid> |
Get person details |
people create \x3Cjson> |
Create person via /events (triggers automations) |
people update \x3Cid> \x3Cjson> |
Update a person |
notes \x3CpersonId> |
Get notes for a person |
notes create \x3Cjson> |
Create a note |
tasks [query] |
List tasks |
tasks create \x3Cjson> |
Create a task |
tasks complete \x3Cid> |
Complete a task |
events [query] |
List events |
events create \x3Cjson> |
Create event (for lead intake) |
pipelines |
Get pipelines |
deals [query] |
List deals |
deals create \x3Cjson> |
Create a deal |
textmessages \x3CpersonId> |
Get text messages for a person |
textmessages create \x3Cjson> |
Log a text (NOT sent - recorded only!) |
emails \x3CpersonId> |
Get emails for a person |
emails create \x3Cjson> |
Log an email (NOT sent - recorded only!) |
calls \x3CpersonId> |
Get calls for a person |
calls create \x3Cjson> |
Log a call |
webhooks |
List webhooks |
webhooks create \x3Cjson> |
Create webhook |
webhooks delete \x3Cid> |
Delete webhook |
sources |
Get lead sources |
users |
Get users/agents |
search \x3Cquery> |
Global search |
Examples
# List people
node fub.js people "limit=10"
# Get person
node fub.js person 123
# Create a lead (triggers automations!)
node fub.js events create '{"source":"Website","system":{"name":"John Doe","email":"[email protected]","phone":"5551234567"}}'
# Add a note
node fub.js notes create '{"personId":123,"body":"Called - left voicemail"}'
# Create task
node fub.js tasks create '{"personId":123,"body":"Follow up","dueDate":"2026-02-20"}'
# Complete task
node fub.js tasks complete 456
# Log a text (NOT sent - recorded!)
node fub.js textmessages create '{"personId":123,"body":"Hey!","direction":"outbound"}'
# Log a call
node fub.js calls create '{"personId":123,"direction":"outbound","outcome":"voicemail"}'
# Search
node fub.js search "john"
Important Notes
- Text/Email Logging: The API can log texts and emails but cannot actually send them. Use FUB's built-in texting or integrations like SendHub for sending.
- Rate Limits: GET /events: 20 req/10 sec, All else: 250 req/10 sec
Usage Guidance
This skill appears to be a straightforward Follow Up Boss CLI, but there are two actionable concerns you should resolve before installing or using it:
- Metadata mismatch: The registry entry declares no required environment variables or primary credential, yet SKILL.md and the code require an API key (FUB_API_KEY). Treat the API key as sensitive: do not paste it into public places and prefer injecting it via secure environment mechanisms.
- Untrusted source/homepage: The skill lists no homepage or known source. If you plan to use it, review the fub.js file yourself (it is included) and confirm it does only what you expect (calls api.followupboss.com). Consider running it in a restricted environment or container first.
Additional notes:
- The code also supports FUB_SYSTEM_KEY and FUB_SYSTEM_NAME (not documented in SKILL.md); if you use system integrations, ensure you understand those headers.
- Ensure your Node runtime provides global fetch or run with a Node version that supports it, otherwise inspect/modify the script to include a fetch polyfill you trust.
- If you proceed, provide the minimum-scoped API key possible, and rotate the key if it is accidentally exposed.
If the publisher can update the registry metadata to list FUB_API_KEY as a required credential and provide a homepage/source repository, that would remove the main inconsistency and increase confidence.
Capability Analysis
Type: OpenClaw Skill
Name: follow-up-boss
Version: 1.0.0
The skill bundle is classified as suspicious due to several input validation vulnerabilities in `fub.js`. Specifically, user-supplied arguments are directly concatenated into URL query strings (e.g., `people?${args[1] || ''}`) and URL paths (e.g., `people/${args[1]}`) without proper sanitization or encoding, except for the `search` command which uses `encodeURIComponent`. This creates a URL injection risk and potential for ID manipulation if a malicious user provides crafted input. There is no evidence of intentional malicious behavior such as data exfiltration, backdoors, or prompt injection against the agent in `SKILL.md`.
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, and fub.js all align: this is a CLI for the Follow Up Boss API and uses the API to manage people, events, notes, tasks, etc. The requested capability (API access) is coherent with the stated purpose. However, the registry metadata declares no required environment variables or primary credential even though both the instructions and the code require an API key, so there is a metadata/documentation mismatch.
Instruction Scope
SKILL.md instructs the agent/user to set FUB_API_KEY and run node fub.js with standard commands. The runtime instructions remain within the scope of the Follow Up Boss API and do not ask the agent to read unrelated files, system state, or transmit data to third-party endpoints. The code only uses the Follow Up Boss API base URL and optional X-System headers.
Install Mechanism
There is no install spec (instruction-only skill), and the included fub.js is plain JavaScript with no obfuscation or external download steps. This is lower risk: nothing will be pulled from arbitrary URLs at install time.
Credentials
The code requires an API credential: FUB_API_KEY (and supports two optional env vars FUB_SYSTEM_KEY and FUB_SYSTEM_NAME). Requesting an API key is proportionate to the task. The concern is that the registry metadata lists no required env vars or primary credential — a discrepancy that could mislead users into installing without realizing a secret must be provided. The SKILL.md documents FUB_API_KEY but does not mention the optional system env vars present in the code.
Persistence & Privilege
The skill is not marked always:true and uses normal, user-invocable behavior. It does not attempt to modify other skills or system-wide settings. No elevated persistence requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install follow-up-boss - After installation, invoke the skill by name or use
/follow-up-boss - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Follow Up Boss CLI skill.
- Supports managing people, notes, tasks, events, deals, webhooks, and more via the Follow Up Boss API.
- Provides commands to create, update, and retrieve entities such as people, tasks, events, notes, calls, text messages, and emails.
- Includes setup instructions and usage examples for key CLI commands.
- Highlights important limitations: logged (but not sent) texts/emails and API rate limits.
Metadata
Frequently Asked Questions
What is Follow Up Boss?
Command-line tool to manage contacts, tasks, notes, deals, events, and communications via the Follow Up Boss API. It is an AI Agent Skill for Claude Code / OpenClaw, with 820 downloads so far.
How do I install Follow Up Boss?
Run "/install follow-up-boss" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Follow Up Boss free?
Yes, Follow Up Boss is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Follow Up Boss support?
Follow Up Boss is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Follow Up Boss?
It is built and maintained by danielfoch (@danielfoch); the current version is v1.0.0.
More Skills