> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.famulor.io/feedback

```json
{
  "path": "/en/mcp/famulor-skill",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Famulor Skill

> Install and use the Famulor.io Skill to let AI agents build and manage assistants, campaigns, knowledge bases, and messaging workflows via the Famulor API.

# Famulor.io Skill

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

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0 }}>
  <iframe style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} src="https://www.tella.tv/video/neuer-famulo-github-skill-automatisierung-per-prompt-hbd4/embed?b=0&title=0&a=1&loop=0&t=0&muted=0&wt=0&o=1" allowFullScreen allowTransparency />
</div>

<Card title="GitHub Repository" icon="github" href="https://github.com/bekservice/Famulor-Skill">
  Source code, installation guides, and examples
</Card>

## 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:

```bash theme={null}
export FAMULOR_API_KEY="your-api-key"
```

Create your API key in the Famulor dashboard: [app.famulor.de](https://app.famulor.de).

## Installation

### Cursor

```text theme={null}
/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

```text theme={null}
Fetch and follow instructions from https://raw.githubusercontent.com/bekservice/Famulor-Skill/refs/heads/main/.codex/INSTALL.md
```

### OpenCode

```text theme={null}
Fetch and follow instructions from https://raw.githubusercontent.com/bekservice/Famulor-Skill/refs/heads/main/.opencode/INSTALL.md
```

### Gemini CLI

```bash theme={null}
gemini extensions install https://github.com/bekservice/Famulor-Skill
```

To update:

```bash theme={null}
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:

```bash theme={null}
export FAMULOR_API_KEY="your-api-key"
```

4. Run:

```bash theme={null}
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.

<Tip>
  Related pages: [MCP Server](/en/mcp/server), [MCP Client](/en/mcp/client), and [API integration examples](/en/developers/api-integration-examples).
</Tip>