Attio

**Judgement:** High-functionality Attio CRM integration via the Maton gateway, suitable for production-grade agents that need deep CRUD access to CRM records and related artifacts, assuming the environment can safely provide the MATON_API_KEY and manage OAuth connections. **Strengths:** - Broad API coverage: objects, records, attributes, tasks, notes, comments, lists, entries, meetings, call recordings, workspace members, and self/token info. - Managed OAuth handled by Maton; the gateway automatically injects Attio OAuth tokens, simplifying auth logic for the agent. - Well-documented request patterns and examples (Python/JS) with clear requirements (e.g., `full_name` for personal-name attributes, task and note required fields, pagination behavior). - Explicit error semantics and troubleshooting guidance (401/403/404/429, scope issues, connection management) aid robust error handling. **Key Risks / Limitations:** - **Data sensitivity:** The skill exposes potentially sensitive CRM data (contacts, companies, meeting notes/recordings); agents must be constrained to least-privilege use and avoid unnecessary bulk export or logging of PII. - **External dependency:** Functionality depends on Maton (gateway + connection controller) and Attio uptime; there is an extra failure surface (API key issues, missing or inactive Attio connections, insufficient OAuth scopes). - **Operational complexity:** Requires prior setup of MATON_API_KEY and one or more active Attio OAuth connections in Maton; multi-connection environments need correct use of the `Maton-Connection` header. - **Rate limiting:** While limits are generous, high-throughput or poorly paginated agents could still hit 429 errors and will need backoff logic. **Recommended Scenarios:** - Agents that enrich, query, and update Attio people/companies and related records as part of sales, customer success, or support workflows. - Assistants that create and manage tasks, notes, and comments tied directly to Attio records after calls, emails, or chat interactions. - Automation agents that maintain lists and segments in Attio or that reconcile Attio data with other systems, making use of the structured query and pagination APIs. - Internal tools where operators understand the implications of granting CRM access and can configure API keys, OAuth connections, and scope management securely.