Metadata-Version: 2.4
Name: matimo-twilio
Version: 0.1.0a14.post1
Summary: Matimo provider — Twilio tools (SMS, MMS, message history)
License: MIT
Keywords: agents,ai,matimo,tools,twilio
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.11
Requires-Dist: matimo-core<0.2.0,>=0.1.0a14.post1
Requires-Dist: twilio>=8.0
Description-Content-Type: text/markdown

# matimo-twilio

> Twilio tools for [Matimo](https://matimo.dev) — send SMS, send MMS, and retrieve message history.

[![PyPI](https://img.shields.io/pypi/v/matimo-twilio)](https://pypi.org/project/matimo-twilio/)
[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)

---

## Installation

```bash
pip install matimo matimo-twilio
```

---

## Available Tools (4 Total)

| Tool | Description |
|------|-------------|
| `twilio-send-sms` | Send an SMS message to a phone number |
| `twilio-send-mms` | Send an MMS message with media |
| `twilio-list-messages` | List sent/received messages with filters |
| `twilio-get-message` | Get details of a specific message by SID |

---

## Quick Start

```python
import asyncio
import os
from matimo import Matimo
from matimo_twilio import get_tools_path

async def main():
    matimo = await Matimo.init(get_tools_path())

    # Send an SMS
    await matimo.execute('twilio-send-sms', {
        'to': '+15551234567',
        'from': '+15559876543',
        'body': 'Hello from Matimo!',
    })

    # List recent messages
    result = await matimo.execute('twilio-list-messages', {
        'limit': 10,
    })
    print(result)

asyncio.run(main())
```

---

## Authentication

```bash
export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="your-auth-token"
```

Find these in your [Twilio Console](https://console.twilio.com/).

---

## Documentation

- [Twilio Messaging API](https://www.twilio.com/docs/messaging)
- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/twilio)

---

## Links

- **PyPI:** https://pypi.org/project/matimo-twilio/
- **GitHub:** https://github.com/tallclub/matimo
- **Twilio Docs:** https://www.twilio.com/docs

