> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.agentphone.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentphone.ai/_mcp/server.

# Claude Code Skill

> Use AgentPhone directly from Claude Code with the official skill

The **AgentPhone Skill** for [Claude Code](https://claude.com/claude-code) gives you phone numbers, voice calls, and SMS right from the command line — no setup beyond an API key.

## Installation

```bash
npx skills add AgentPhone-AI/skills
```

Or install manually via git:

```bash
git clone https://github.com/AgentPhone-AI/skills.git
```

## Configuration

Set your API key as an environment variable:

```bash
export AGENTPHONE_API_KEY=your_key_here
```

Get your API key from [agentphone.ai/settings](https://agentphone.ai/settings).

## Features

The skill covers all AgentPhone capabilities through a single `/agentphone` command:

| Capability              | Description                                                  |
| ----------------------- | ------------------------------------------------------------ |
| **Account Overview**    | Get a snapshot of agents, numbers, webhooks, and usage       |
| **Agents**              | Create, update, delete, and list AI voice agents             |
| **Phone Numbers**       | Buy, list, release numbers, and attach to agents             |
| **Voice Calls**         | Make AI-powered outbound calls with autonomous conversations |
| **SMS & Conversations** | Read messages, view conversation threads                     |
| **Webhooks**            | Set up project-level and per-agent webhook endpoints         |
| **Usage & Billing**     | Check balance, usage stats, and consumption trends           |
| **Voices**              | List available voices for agent configuration                |

## Example Usage

```
> /agentphone create an agent called Support Bot

> /agentphone buy a US phone number with area code 415

> /agentphone call +14155551234 and ask about their return policy

> /agentphone show me recent calls and transcripts

> /agentphone check my SMS conversations

> /agentphone set up a webhook at https://my-server.com/hook

> /agentphone show my usage stats

> /agentphone what voices are available?
```

## How It Works

The skill connects Claude Code to the [AgentPhone MCP Server](/mcp), which translates natural language requests into API calls. All state (numbers, calls, messages) lives on the AgentPhone platform.

```
Claude Code  →  /agentphone skill  →  AgentPhone MCP  →  AgentPhone API  →  Phone Network
```

## Resources

* [GitHub Repository](https://github.com/AgentPhone-AI/skills)
* [MCP Server Docs](/mcp)
* [API Reference](/api-reference)
* [AgentPhone Console](https://agentphone.ai)