# ponlo-ai

MCP server for [Ponlo.ai](https://ponlo.ai) — manage your family hub from Claude, ChatGPT, or any MCP client.

[![npm](https://img.shields.io/npm/v/ponlo-ai)](https://www.npmjs.com/package/ponlo-ai)

## Quick Start

```json
{
  "mcpServers": {
    "ponlo": {
      "command": "npx",
      "args": ["-y", "ponlo-ai"],
      "env": {
        "PONLO_API_KEY": "your_key_here",
        "PONLO_API_URL": "https://ponlo.ai"
      }
    }
  }
}
```

Get your API key at [ponlo.ai/admin](https://ponlo.ai/admin) → Workspace → Generate API Key.

See [MCP_SETUP.md](../MCP_SETUP.md) for full setup instructions.

## Tools (40+)

### Tasks

`ponlo_tasks_list` · `ponlo_tasks_create` · `ponlo_tasks_update` · `ponlo_tasks_complete` · `ponlo_tasks_uncomplete` · `ponlo_tasks_delete` · `ponlo_tasks_reorder` · `ponlo_tasks_bulk_complete` · `ponlo_tasks_bulk_create`

### Calendar

`ponlo_calendar_list_events` · `ponlo_calendar_create_event` · `ponlo_calendar_update_event` · `ponlo_calendar_delete_event` · `ponlo_calendar_sync`

### Notes

`ponlo_notes_get` · `ponlo_notes_create` · `ponlo_notes_update` · `ponlo_notes_delete`

### Lists

`ponlo_lists_list` · `ponlo_lists_create` · `ponlo_lists_delete` · `ponlo_lists_get_items` · `ponlo_lists_add_items` · `ponlo_lists_check_item` · `ponlo_lists_remove_item`

### Meals

`ponlo_meals_list` · `ponlo_meals_create` · `ponlo_meals_update` · `ponlo_meals_delete`

### Rewards

`ponlo_rewards_list` · `ponlo_rewards_create` · `ponlo_rewards_redeem` · `ponlo_rewards_delete`

### Schedule

`ponlo_schedule_get` · `ponlo_schedule_set`

### Reminders

`ponlo_reminders_list` · `ponlo_reminders_create` · `ponlo_reminders_delete`

### Other

`ponlo_family_members` · `ponlo_weather` · `ponlo_daily_briefing` · `ponlo_standup` · `ponlo_import` · `ponlo_import_recipe` · `ponlo_photos_upload` · `ponlo_photos_list` · `ponlo_photos_delete` · `ponlo_widgets_list` · `ponlo_widgets_configure` · `ponlo_displays_list` · `ponlo_displays_create` · `ponlo_displays_delete` · `ponlo_webhooks_list` · `ponlo_webhooks_create` · `ponlo_webhooks_delete`

## Security

- API keys are hashed (SHA-256) before storage
- All requests are workspace-scoped
- Keys can be revoked anytime at [ponlo.ai/admin](https://ponlo.ai/admin)
- Audit trails track who performed each action

## Development

```bash
cd mcp-server
npm install
npm run build   # compile TypeScript
npm run dev     # run with tsx (no build needed)
```

## License

MIT