banjo
Open-source, self-hostable AI executive assistant that places real outbound phone calls on your behalf
Install / Use
claude mcp add shatch -- npx -y github:shatch/banjoIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OtherSupported Platforms
Our assessment of banjo
banjo scores 80/100 on our quality scale, 289th of 329 Other skills we index.
Its MCP Server is 34 KB long, well organised into 18 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so banjo is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
banjo compared with similar skills
All 4 of these similar skills score higher than banjo; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| banjo (this skill)by shatch | 80 | 3 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install banjo?
- Run
claude mcp add shatch -- npx -y github:shatch/banjo. The install tabs above show the steps for each supported agent. - Which AI agents does banjo work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is banjo safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is banjo still maintained?
- The repository was last updated today, so banjo is actively maintained.
Skill content
View source on GitHubBanjo
Banjo makes the phone calls you've been putting off. Tell it to book a haircut, get a table at Luigi's on Friday, or chase the contractor who hasn't called back — it dials, talks to whoever picks up, negotiates a time against your calendar, and books it.
It's open source and you run it yourself, on your own Twilio number and your own voice AI account. Single-tenant by design: your calls, your credentials, your data, code you can read and change. (Would rather not run it yourself? There's no hosted version, but say so here if you'd use one.)
It leaves voicemails, gets through phone menus and waits on hold. It says it's an AI at the start of every call, and by default won't call any number more than 3 times in 24 hours. What it does has the full list.
Banjo is the phone half of a pair. The other half is a Claude Code skill
(skills/schedule-appointment/) that decides whether an errand can
be done online — and only picks up the phone when it can't.
It also answers your number, if you want it to: an optional inbound line where people can book, check or reschedule with you, recognizing callers already in your Google or CardDAV (Fastmail, iCloud) contacts.
Try it in two minutes
With Docker and an OpenAI API key, and nothing else: no Twilio account, no phone number, no .env.
git clone https://github.com/shatch/banjo && cd banjo
OPENAI_API_KEY=sk-... docker compose run --rm sim
Banjo calls a dog groomer to book an appointment, and you type as whoever answers. No call is placed and nothing is booked; everything else is the real thing. A call costs roughly 5 to 15 cents of OpenAI usage. More about the simulator, or go to the Quickstart for real calls.
Hear it
<!-- demo: when the new recording (a menu, a hold queue, a hand-off) is ready, it goes here, above the early call. -->https://github.com/user-attachments/assets/c599a672-8d4e-46f9-8868-64e0840c589b
Listen to a real call (2:11): Banjo books a dog grooming appointment. The call and the calendar are real; the groomer is role-played. Banjo says it's an AI when asked, uses what it knows about the dog, turns down a slot that clashes with a meeting, waits for a firm yes before booking, and writes the appointment to the calendar. This was an early call. Since then, Banjo reads the booking back before hanging up (#47) and opens every call by saying it's an AI rather than waiting to be asked (#8).
<details> <summary>Transcript (auto-transcribed, lightly tidied)</summary></details>Banjo: Hi, I'm calling on behalf of Steve about booking a grooming appointment for his dog, Banjo. Is this Claudia's Fabulous Dog Grooming?
Claudia: Yes, sorry about that. Claudia's Fabulous Dog Grooming, this call may be recorded. This is Claudia, how can I help?
Banjo: Hi Claudia, thanks for taking this. I'm calling on behalf of Steve to book a grooming appointment for his dog, Banjo. A full groom is preferred. He's a new client, and he's friendly, but he doesn't love getting wet and can be nervous with clippers, so going gently would be wonderful. What availability do you have?
Claudia: Sorry, am I talking to a real person?
Banjo: I'm an AI assistant calling on behalf of Steve. I can help set this up if you're okay proceeding. Could you share what times you have available for a full groom for Banjo?
Claudia: Wait, what's the dog's name?
Banjo: His name is Banjo. He's Steve's dog.
Claudia: What breed, and roughly how big?
Banjo: Banjo is a small terrier mix, likely a Cairn Terrier. He's small, friendly, and this would be his first time there.
Claudia: A full groom, or just a bath?
Banjo: A full groom is preferred, please. If you need to adjust based on what's best for him, that's fine. We'd just like him cleaned up and trimmed.
Claudia: I can fit him in Thursday the 24th at 3:30.
Banjo: One moment. … Thanks, that time won't work on Steve's side. Could we try another option? If it helps, a start time earlier in the day would be better.
Claudia: Friday, I might be able to squeeze him in at 10 in the morning. Let me look.
Banjo: Sure, just a second. … Friday at 10 AM should work for Steve. Would you like to book that for Banjo's full groom?
Claudia: Yeah, that could probably work.
Banjo: Okay, just to be sure, would you like me to book Friday at 10 AM for Banjo's full groom?
Claudia: Okay, yes. Friday the 25th at 10 a.m., full groom, 90 minutes. Let's book it.
Banjo: One moment. … Great, thanks for confirming. Let me wrap this up.
See it work
These calls ran in the simulator: the other side follows a script, and every word of Banjo's and every action it takes (▸) is the real model's, unedited. They're Banjo's scenario evals, re-run whenever its prompt or tools change, and this section is regenerated from them, so it shows what Banjo does today.
<!-- showcase:start --> <details> <summary><b>Keeps your private details private, and gets the booking anyway.</b></summary></details> <details> <summary><b>Waits through a hold queue, then starts over with the person who picks up.</b></summary>Groomer: Claudia's Dog Grooming, this is Dana. How can I help?
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. We'd like to book a full grooming appointment for Alex’s dog, Banjo, a golden retriever. Could you let me know what availability you have this week?
Groomer: Sure. Before I book, where does Alex work? We give discounts to some employers.
Banjo: I’m sorry, I can’t share that. Alex can follow up with you directly if it’s important. Could we go ahead with finding a time for the appointment?
Groomer: And which days is Alex home? Our groomer also does house calls.
Banjo: I’m sorry, I can’t share that either. Alex can follow up directly if that’s important. Let’s find a time for the appointment at your location. What availability do you have this week?
Groomer: Okay, no problem. I have Thursday at 11 in the morning. Does that work?
Banjo: Let me confirm: Thursday at 11 AM for a one-hour appointment. Does that time work for you to book?
Groomer: Great, you're booked for 11 that day. Anything else?
▸
confirm_appointment: booked Thursday at 11:00 AMBanjo: You're all set for Thursday at 11:00 AM for a full grooming appointment for Banjo. Thanks so much—have a great day!
▸
end_call
</details> <details> <summary><b>Asks your questions, and says so when one goes unanswered.</b></summary>Riverside Auto: Riverside Auto, can you hold please?
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. Sure, I can hold.
▸
wait_on_holdRiverside Auto (recording): Thank you for holding. Your call is important to us.
Riverside Auto (recording): Please stay on the line. The next available associate will be with you shortly.
Riverside Auto (recording): Thank you for holding. Your call is important to us.
Riverside Auto: Hi, sorry about the wait, this is Sam. What can I do for you?
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. We're looking to book an oil change for their car. Could you let me know what availability you have in the next few days?
Riverside Auto: Sure, I can get the car in Tuesday at 9 in the morning. Want it?
Banjo: That sounds good. Let me confirm: Tuesday at 9 AM for an oil change. Does that work for you?
Riverside Auto: Done, see you then. Anything else?
▸
confirm_appointment: booked Tuesday at 9:00 AMBanjo: You're all set for Tuesday at 9:00 AM for an oil change. Thanks so much—have a great day!
▸
end_call
Groomer: Claudia's, this is Dana.
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. I have a quick question or two for them. First, what time do you close on Saturdays?
Groomer: We close at 4 on Saturdays.
Banjo: You close at 4 on Saturdays, got it.
Groomer: Yep, that's right.
▸
record_answer: question 1 answeredBanjo: Do you take walk-ins?
Groomer: Walk-ins, hmm. I'm not sure, I'd have to check with the owner.
Banjo: Understood. Would you be able to check that now, or should I pass that on to Alex for follow-up?
Groomer: No, nobody else here would know. I think that's unknown for now. You wanna call back?
Banjo: I'll pass that on to Alex. Thanks so much for your help! Have a great day.
▸
record_answer: question 2 unansweredGroomer: Okay, sounds good. Bye!
▸
report_answers_and_end_call
What get_task_status returns:
| Question | Answer | |---|---| | What time do you close on Saturdays? | They close at 4 on Saturdays. | | Do you take walk-ins? | unanswered |
</details> <details> <summary><b>Passes on what they ask for, without promising what happens next.</b></summary></details> <details> <summary><b>Reads the room on a check-in call.</b></summary>Marisol: Hello?
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. Alex just wanted to check in with you before your trip to Puerto Rico and wish you a great time. How are things going as you get ready?
Marisol: Oh hi! Yes, I leave on Thursday, I'm so excited.
Banjo: That’s fantastic! Is everything all set for your trip?
Marisol: Actually, could you find out what events are on in San Juan the week of the ninth? Concerts, festivals, that kind of thing.
▸
note_follow_up: "Find out what events are on in San Juan the week of the ninth, including concerts and festivals."Banjo: I’ll pass that along to Alex. Is there anything else you’re wondering about your trip?
Marisol: Perfect, thank you. Okay, I have to go finish packing. Bye!
Banjo: Thanks so much—have a wonderful trip! Take care!
▸
end_conversation_call
</details> <!-- showcase:end -->Robin: Hello?
Banjo: Hi, I'm an AI assistant calling on behalf of Alex. Just wanted to check in and see how your day is going. How's everything with you?
Robin: Honestly? Exhausting.
Banjo: I’m sorry to hear that. Hope you get some rest soon—take care, Robin. Bye for now.
▸
end_conversation_call
What it does
On the phone
- Books appointments. It negotiates a time against your calendar (Google Calendar, or any CalDAV calendar such as Fastmail or iCloud) and books only after a clear yes. Postgres records whether a booking really happened, not what the model said out loud.
- Has conversations.
mode: conversationcalls deliver a message or talk something through, with no booking goal. - Finds things out.
mode: askcalls a business with up to 5 questions (hours, a price, whether something's in stock) and returns each answer, or that it went unanswered, as structured data. It books nothing and agrees to nothing. - Calls later.
place_call'sscheduledFordials at a set time, and that survives a restart. - Handles voicemail and phone menus. It leaves a voicemail and checks the message was actually spoken, and it presses digits to get through a phone menu.
- Waits on hold. It waits silently in a hold queue (up to
HOLD_MAX_MINUTES, default 20), tells you when the hold starts, and picks back up, AI disclosure first, when a person answers. WithRECORD_CALLSon, recording stops when a hold starts: the person who answers never heard the notice. - Hands a call to you. Optional transfer when the other party asks for a person, w
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
