copper

# 🟤 Copper CRM

Copper CRM integration — manage people, companies, opportunities, projects, tasks, and activities via the Copper REST API.

## Features

- **People management** — contacts with full CRUD and search
- **Company tracking** — organizations, details, relationships
- **Opportunity pipeline** — deals, stages, values, win rates
- **Project management** — track projects with stages and tasks
- **Task management** — create, assign, complete tasks
- **Activity logging** — calls, meetings, notes on any record
- **Relationship mapping** — see connections between records
- **Search** across all entity types
- **Custom fields** — read and write custom field values
- **Pipeline reports** — value, velocity, conversion metrics

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `COPPER_API_KEY` | ✅ | API key/token for Copper CRM |
| `COPPER_EMAIL` | ✅ | Your Copper account email |

## Quick Start

```bash
# List people/contacts
python3 {baseDir}/scripts/copper.py people --limit 20
```

```bash
# Get person details
python3 {baseDir}/scripts/copper.py person-get 12345
```

```bash
# Create a person
python3 {baseDir}/scripts/copper.py person-create '{"name":"Jane Doe","emails":[{"email":"jane@example.com"}]}'
```

```bash
# Update a person
python3 {baseDir}/scripts/copper.py person-update 12345 '{"title":"VP Sales"}'
```



## Commands

### `people`
List people/contacts.
```bash
python3 {baseDir}/scripts/copper.py people --limit 20
```

### `person-get`
Get person details.
```bash
python3 {baseDir}/scripts/copper.py person-get 12345
```

### `person-create`
Create a person.
```bash
python3 {baseDir}/scripts/copper.py person-create '{"name":"Jane Doe","emails":[{"email":"jane@example.com"}]}'
```

### `person-update`
Update a person.
```bash
python3 {baseDir}/scripts/copper.py person-update 12345 '{"title":"VP Sales"}'
```

### `companies`
List companies.
```bash
python3 {baseDir}/scripts/copper.py companies --limit 20
```...