Skip to main content

​
Famulor.io Skill

The Famulor.io Skill enables AI agents to execute real tasks in Famulor, not just explain them.

GitHub Repository

Source code, installation guides, and examples

​
What this skill does

  • Create and configure AI assistants (inbound, outbound, chat, WhatsApp)
  • Set up outbound campaigns and manage leads
  • Connect knowledge bases and documents
  • Create mid-call tools (HTTP tools) for live integrations
  • Run WhatsApp and SMS workflows
  • Support testing and iterative prompt and voice optimization

​
When to use this skill

Use this skill for requests related to:
  • Famulor or famulor.io setup
  • Campaigns, leads, and outbound calling
  • WhatsApp bots, templates, and SMS
  • Knowledge bases, RAG documents, and webhooks
  • Famulor API integrations

​
Requirements

You need a valid API key as an environment variable: 
export FAMULOR_API_KEY="your-api-key"
Create your API key in the Famulor dashboard: app.famulor.de.

​
Installation

​
Cursor

/add-plugin https://github.com/bekservice/Famulor-Skill
If direct URL installation is not available, import famulor.skill manually and restart the chat session.

​
Codex

Fetch and follow instructions from https://raw.githubusercontent.com/bekservice/Famulor-Skill/refs/heads/main/.codex/INSTALL.md

​
OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/bekservice/Famulor-Skill/refs/heads/main/.opencode/INSTALL.md

​
Gemini CLI

gemini extensions install https://github.com/bekservice/Famulor-Skill
To update: 
gemini extensions update famulor-skill

​
Universal manual installation

  1. Download famulor.skill from the repository.
  2. Import/register it in your agent platform as a custom skill or plugin.
  3. Restart the agent session.
  4. Set FAMULOR_API_KEY.
  5. Ask the agent to execute a Famulor workflow.

​
Local developer quickstart

  1. Clone the repository.
  2. Ensure Python 3.10+ is installed.
  3. Set your API key:
export FAMULOR_API_KEY="your-api-key"
  1. Run:
python3 scripts/famulor_client.py list_assistants
If your key is valid, you receive API data as JSON.

​
Verify installation

  • echo $FAMULOR_API_KEY returns a non-empty value
  • python3 scripts/famulor_client.py list_assistants returns API data
  • No 401 Unauthorized error appears

​
Security notes

  • Never commit API keys to Git.
  • Prefer local environment variables or an ignored .env file.
  • Rotate API keys immediately if exposed.
Related pages: MCP Server, MCP Client, and API integration examples.