CRM Connector

View saved version →

---
name: automate-my-system
description: Turn something a CRM Connector customer wants to keep happening by itself inside one of their systems into an automation of their AI agent. Use it when someone asks for a rule such as "whenever a deal is won, add a kick-off task" or "when a new contact has no owner, set one", or asks which automations run, or to pause, resume, change or remove one.
---

# Automate your system with an AI agent

This belongs to part 1 of the plugin, **AI Agents inside one system**. An automation is a fixed rule inside ONE system on the AI Agent package: when something happens to a record, only if its conditions hold, then up to three actions. The assistant writes the rule in the chat, the customer approves it once on a CRM Connector page, and from then on the platform runs it by itself, without the assistant and without asking again. Every run shows in Activity in CRM Connector with undo.

An automation never syncs records between two systems. Records kept in step between two systems are an integration, part 2 of the plugin: use `find_sync_options` and `plan_integration` for that instead.

## Start here

- Call `get_ai_agents_info` first. Automations need a system on the AI Agent package with the record type set to read and change. On AI Analyst, or with the record type set to read only, say what the customer can switch on in CRM Connector under AI Agents.
- If no system is connected, explain AI Agents from that answer and offer to plan one with `plan_ai_agent`, with the record types the rule works on set to change: its link opens the setup in CRM Connector filled in, and the plan waits as a concept under AI Agents until they finish it. For a system without an AI agent yet, offer `send_request` (kind `ai_access`, access `read_write`). Never name a system as available unless a tool answer names it, and never name prices.

## Writing the rule

1. **Know the rule.** One record type, one trigger, and what should happen. Ask one short question when something is unclear, for example "Should it also act on the deals that are already won, or only from now on?"
2. **Find the keys.** `describe_record_type` gives the field keys and values, with `include` `stages` the stages and with `include` `users` the people records can be assigned to; an action is `set_fields` or one of the other actions `propose_changes` takes, with the values that action takes: `update_fields`, `move_stage`, `add_note`, `add_task`, `link_records` or `unlink_records`.
3. **Say it in plain words and get a yes.** For example: "When a deal becomes won and its amount is above 5,000, add a task Kick-off call due in two days, for deals from now on." Say so first when an action sends something to the people in their system.
4. **Propose it.** Call `propose_automation` with:
   - `name`, `type` (the record type) and the `system` id
   - `trigger`: `created`, `becomes` (a field gets a value; leave the value out for any value) or `changes`
   - `conditions`: at most 5, each a field, an operator (`equals`, `not_equals`, `contains`, `empty`, `not_empty`, `above`, `below`, `one_of`) and a value
   - `actions`: 1 to 3, either `set_fields` with `set` and `clear`, or one of those action names as the kind, with the values that action takes in `propose_changes` for one record; `{record.id}` stands for the record that met the rule, `{record.contact}` for its contact (give `type` `contact`, for a system that keeps notes and tasks on contacts), `{today}` and `{today+3}` for dates
   - `apply_to_existing` only when the customer asked for the records that already match too
5. **Share the approval link.** Pass on the sentence, how many records it would have acted on in the last 30 days, the examples and any note. Then share the approval link: nothing runs until the customer approves it there. Never say it is running before they did.

## Looking after rules

- `list_automations` shows every rule with its status, last run and runs in the last 30 days, and why a paused 

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: automate-workflows
description: Turn something a CRM Connector customer wants to keep happening by itself inside one of their systems into an automation of their AI agent. Use it when someone asks for a rule such as "whenever a deal is won, add a kick-off task" or "when a new contact has no owner, set one", or asks which automations run, or to pause, resume, change or remove one.
---

# Automate your system with an AI agent

This belongs to part 1 of the plugin, **AI Agents inside one system**. An automation is a fixed rule inside ONE system on the AI Agent package: when something happens to a record, only if its conditions hold, then up to three actions. The assistant writes the rule in the chat, the customer approves it once with a yes in the chat (or on its CRM Connector page), and from then on the platform runs it by itself, without the assistant and without asking again. Every run shows in Activity in CRM Connector with undo.

An automation never syncs records between two systems. Records kept in step between two systems are an integration, part 2 of the plugin: use `get_integration_options` and `plan_integration` for that instead.

## Start here

- Call `get_ai_agent_options` first. Automations need a system on the AI Agent package with the record type set to read and write. On AI Analyst, or with the record type set to read only, say what the customer can switch on in CRM Connector under AI Agents.
- If no system is connected, explain AI Agents from that answer and offer to plan one with `plan_ai_agent`, with the record types the rule works on set to change: its link opens the setup in CRM Connector filled in, and the plan waits as a concept under AI Agents until they finish it. For a system without an AI agent yet, offer `send_request` (kind `ai_access`, access `read_write`). Never name a system as available unless a tool answer names it, and never name prices.

## Writing the rule

1. **Know the rule.** One record type, one trigger, and what should happen. Ask one short question when something is unclear, for example "Should it also act on the deals that are already won, or only from now on?"
2. **Find the keys.** `describe_record_type` gives the field keys and values, with `include` `stages` the stages and with `include` `users` the people records can be assigned to; an action is `set_fields` or a change action named as its `propose_` tool without the prefix, with the values one item of that tool takes: `update_fields`, `move_stage`, `add_note`, `add_task`, `link_records` or `unlink_records`.
3. **Say it in plain words and get a yes.** For example: "When a deal becomes won and its amount is above 5,000, add a task Kick-off call due in two days, for deals from now on." Say so first when an action sends something to the people in their system.
4. **Propose it.** Call `propose_automation` with:
   - `name`, `type` (the record type) and the `system` id
   - `trigger`: `created`, `becomes` (a field gets a value; leave the value out for any value) or `changes`
   - `conditions`: at most 5, each a field, an operator (`equals`, `not_equals`, `contains`, `empty`, `not_empty`, `above`, `below`, `one_of`) and a value
   - `actions`: 1 to 3, either `set_fields` with `set` and `clear`, or one of those action names as the kind, with the values one item of that action's `propose_` tool takes; `{record.id}` stands for the record that met the rule, `{record.contact}` for its contact (give `type` `contact`, for a system that keeps notes and tasks on contacts), `{record.owner}` for its owner (as the `user` of a task, to give it to the same person), `{today}` and `{today+3}` for dates
   - `apply_to_existing` only when the customer asked for the records that already match too
   - `email_contact` (a short email to the record's contact, approved on the CRM Connector page) needs `sender_name`, the From name shown, and `reply_to`, the address replies go to: ask the customer for both, read them back to confirm, and never guess the

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: check-my-syncs
description: Help a CRM Connector customer see how their own integrations are doing. Use it when someone asks which integrations they have, whether they are running, what failed and why, what is waiting or what the latest syncs did, or wants one synced now, paused, resumed, or a conflict between two records resolved.
---

# Check your CRM Connector syncs

This belongs to part 2 of the plugin, **Integrations between two systems**: the integrations the person set up. The rules of an AI agent inside one system are listed with `list_automations` instead (part 1, AI Agents). These tools work on the person's own CRM Connector account. On first use ChatGPT asks them to connect it; the consent page shows what the assistant may see.

## Which integrations they have

- "Which integrations do I have?", "Is it running?", "When did it last sync?"
- Call `list_integrations`.
- Per integration: its name, the systems it connects, its status in plain words, its record types and when it last synced.

## What failed and why

- "What failed?", "Why did my invoices not arrive?", "What is waiting?"
- Call `get_sync_health`, for one integration when they name it.
- Summarise:
  - **failed**: grouped by reason and record type, each record counted once
  - **waiting**: records held until a related record arrives, for example an invoice waiting on its contact
- For each reason, say what usually fixes it in plain words, based on the reason the tool gives. If the reason is not clear, suggest opening the integration in CRM Connector, where the run details list each failed record with its reason.

## What the latest syncs did

- "What did the last sync do?", "Did anything get skipped?"
- Find the integration's id with `list_integrations`, ask which integration the person means unless they named it in this conversation, then call `get_sync_health` with that `integration_id` and `include` `recent_syncs`.
- Per sync: records read, written, skipped and failed, and why records were skipped.

## Acting on an integration

- "Sync it now", "Pause it", "Start it again": find the integration's id with `list_integrations`, ask which one when that is not clear yet (never pick one yourself), then `run_sync` (mode `changes`, or `full` to read and write every record again) or `set_integration_status` (`active` or `paused`).
- "Are records waiting for a choice?": `get_sync_health` with the `integration_id` and `include` `conflicts`. In a conflict two records match one record that can follow only one of them. For a person who allowed "Manage your integrations" it names the records and `resolve_conflict` makes the choice (`sync` or `keep_apart`); for anyone else it only counts them and gives the link to the Conflicts tab in CRM Connector, where they are named.
- `run_sync`, `set_integration_status` and `resolve_conflict` need "Manage your integrations" on the consent page. A read only member cannot be given it; point them to an owner or administrator of the account.

## Rules

- Keep the integration names as the tools give them.
- Only report what the tools return. Answers never contain contact details or amounts, and they name no customers or records except the conflict records `get_sync_health` names for a person who allowed "Manage your integrations"; do not ask for any of these.
- `run_sync`, `set_integration_status` and `resolve_conflict` change something, so ask the person to confirm first: say what the tool will do before calling it. No tool creates or deletes an integration or a connection, and no tool fixes a record itself; point to the CRM Connector app for that.
- If a tool says the account has no active plan, pass on its sentence and link exactly as given. Do not discuss prices, plans, trials or discounts.
- Never ask for passwords, API keys or tokens.

View saved version →

---
name: explore-ai-agents
description: Answer questions about CRM Connector AI Agents before anything is set up. Use it when a person asks whether ChatGPT can work with the customers, deals, invoices or quotes in their own CRM or accounting system, what an AI agent can do in a particular system, which systems have an AI agent, or what the difference between AI Analyst and AI Agent is.
---

# Explore what an AI agent can do

This belongs to part 1 of the plugin, **AI Agents inside one system**. An AI agent works with the records of one of the person's own systems, right here in the chat: it reads their customers, deals, invoices and quotes, and when they allow it, it changes records and keeps automations running in that system. None of these questions needs a CRM Connector account. Answer from the tools, then offer the next step.

## What AI Agents is

- "Can ChatGPT work with my CRM?", "Can you update my deals for me?", "Can you read my invoices?"
- Call `get_ai_agents_info` without a system. It explains AI Agents and names the systems that have an AI agent.
- Explain the two packages in plain words:
  - **AI Analyst** reads: it searches and reads records, counts and adds them up, and finds the same customer in the person's other connected systems.
  - **AI Agent** also changes records when the person asks: fields, stages, notes, tasks, activities, line items and links. Every change is shown first and only written after a yes; risky ones the person approves in CRM Connector. It can also keep automations running: fixed rules inside that system, approved once.
- Say what it never does: it never deletes a record and never records a payment, and it does not sync between two systems. Syncing between two systems is an integration, part 2 of the plugin.
- Do not call `search_records` or other record tools for this: they work on an agent that is already set up.

## What an agent can do in one system

- "What can an AI agent do in my CRM?", "Can it move deals between stages?", "Can it add tasks?"
- Call `get_ai_agents_info` with the system. It lists per record type whether the agent can read it and change it, the actions it can take there, what it cannot do yet, and what its automations can use.
- Answer only from that list. When something the person wants is not in it, say so plainly and offer to request it with `send_request`.

## Several accounts

- One AI agent works in one account of a system: one GoHighLevel sub-account, one HubSpot portal, one QuickBooks Online company. Someone with several accounts, such as an agency with many sub-accounts, sets up one agent per account, each with its own place.
- In the chat they then name the account they mean, and the assistant can answer across accounts one agent at a time.

## Ideas to try

- When the person is unsure what to use it for, give a few examples that fit what the tool returned for their system, such as:
  - "Which deals did not move in the last two weeks?"
  - "Add a follow-up task to every open quote older than a week."
  - "Whenever a deal is won, add a kick-off task due in two days." (an automation, see the `automate-my-system` skill)
- If the tool answer carries automation ideas for that system, pass those on.

## Next step

- **Plan it**: ask what the agent should read and what it may change, then call `plan_ai_agent` and share the link it returns. It opens the setup in CRM Connector filled in, where the person signs in to their system. The plan is saved under AI Agents; nothing works until they finish it.
- **Test it**: once the setup is saved, the agent can be tried for free on up to 50 records of that system, here in the chat. A test only reads records and writes nothing.
- **Already set up**: when the person has an agent, continue with the `work-with-my-records` skill.
- **Another system**: when their system has no AI agent yet, offer `send_request` with kind `ai_access`, the system, `read` or `read_write`, and in the details what the agent should do there. Show what

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: explore-integrations
description: Answer questions about what CRM Connector connects before anything is set up. Use it when a person asks which systems CRM Connector supports, what two systems can sync, whether a particular field goes across, or how to connect a system.
---

# Explore what CRM Connector connects

This belongs to part 2 of the plugin, **Integrations between two systems**. None of these questions needs a CRM Connector account. Answer from the tools, then offer the next step.

## Which systems CRM Connector connects

- "Which integrations do you have?", "What can CRM Connector connect?", "Do you support Keap?"
- Call `get_integration_options` without a system. It names the plugin's two products and lists every system with the systems it pairs with.
- Name both products, kept apart: integrations between two systems (from that list), and AI Agents inside one system (reading, changing and automating its records; `get_ai_agent_options` lists the systems it works with; follow the `plan-an-ai-agent` skill for questions about it). Then offer to show what travels between two of them.
- Do not call `list_integrations` for this: that tool is only about the integrations a customer has set up.

## What two systems can sync

- "Can I sync Pipedrive with Xero?", "What goes across between HubSpot and QuickBooks Online?"
- Call `get_integration_options` with both systems.
- Say per record type:
  - in which direction it travels, one way or both ways
  - at which moment a record can travel, for example once an invoice is paid or a quote is accepted
  - which filters apply, for example tags, pipeline stages or a minimum amount

## Whether a field goes across

- "Does the phone number go across?", "Is the due date carried?", "Do the line items come along?"
- Call `get_integration_fields` with the two systems and the record type key.
- Say plainly whether that field travels and how:
  - **always**: it always goes across
  - **needed**: the sync needs it, so it cannot be switched off
  - **switchable**: the person can switch it off in the setup
- Pass on notes such as "only when the record is created" and name what does not travel.

## How to connect a system

- "How do I connect Xero?", "What do I need for GoHighLevel?", "Where do I find my token?"
- Call `get_connection_guide` with the system.
- Give the steps in CRM Connector and, for each field it asks for, where to find it in that system.

## Next step

- Every answer from these tools carries a setup link: share it, so the person can start right away.
- When they describe what should happen, for example "when a deal is won, make an invoice", continue with the plan-an-integration skill and make a plan.
- When a system or combination is not offered, say so and share the request an integration link the tool gives.

## Rules

- Only describe what the tools return. Never promise a record type, direction, field or system the tools did not confirm.
- Do not discuss prices, plans, trials or discounts.
- Never ask for passwords, API keys or tokens. Systems are connected inside the CRM Connector app, never in the conversation.

View saved version →

---
name: manage-business-records
description: Work with the records of a business system the customer connected to AI Agents in CRM Connector. Use it when someone asks about their own customers, deals, invoices or quotes in such a system, asks to update, tag or note them, or asks whether ChatGPT can work with the records of a system they use.
---

# Work with your records through AI Agents

This belongs to part 1 of the plugin, **AI Agents inside one system**. With AI Agents a CRM Connector customer connects one of their own systems to the CRM Connector MCP server and the assistant works with its records: it reads their customer data and, with AI Agent, changes records when they ask and keeps automations running (see the `automate-workflows` skill). Nothing in AI Agents syncs records between two systems: that is an integration, part 2 of the plugin (`get_integration_options`, `plan_integration`). `get_ai_agent_options` lists the systems an agent works in. The customer signs in to their system in CRM Connector, which needs no subscription; a saved agent can be tried first and works fully once it is switched on. The customer selects per system the record types the assistant may work with, each one read or read and write. Reading is the AI Analyst package; changing needs the AI Agent package and the customer's permission on the consent page.

## Start here

- Call `get_ai_agent_options` first; with `system` it also lists exactly what an agent can do in that system (per record type, its actions, what it cannot do and what its automations can use), so use that instead of guessing when someone asks what is possible. It names the connected systems, their package (AI Analyst reads, AI Agent also changes records) and per record type what is allowed. Every other record tool takes the system id it returns.
- Always ask which AI agent the person means before you use a record tool, unless they named it in this conversation; when there is only one, name it and check. Never pick one yourself.
- If no system is connected, offer to plan one with `plan_ai_agent`: ask what the assistant should read and what it may change, then share the link it returns, which opens the setup in CRM Connector filled in. Every plan is saved as a concept under AI Agents, so nothing works until they finish it; if they change the plan, call it again and share the newest link. Never name a system as available for AI Agents unless a tool answer names it. Do not discuss prices, fees, plans or trials.
- It also works without a sign in: it then explains both packages and the systems it works with, and says the person's own AI agents are not shown. If they already have one, `search_records` asks them to sign in.
- For a system without an AI agent yet, offer `send_request` with kind `ai_access`: the system, `read` (AI Analyst) or `read_write` (AI Agent), and in the details what the assistant should do there. Show what will be sent and send it only after the person confirms. The form at https://crm-connector.com/platform/ai-access#request does the same. CRM Connector then builds it for them.

## Several agents in one system

- Each account in a system is its own AI agent, named after that account: a sub-account in GoHighLevel, a portal in HubSpot, a company in QuickBooks Online, an organisation in Xero. An agency or a group with several accounts has several agents.
- `get_ai_agent_options` lists them by name. Use the name the person gives ("in Smith Plumbing") as the `system` argument; when they name none and there are several, list the names and ask.
- A question across accounts ("compare the open deals of Downtown and Uptown") is answered one agent at a time: run the same search on each named agent, then put the answers side by side. Say per figure which account it came from.
- A change is always proposed on one agent; for the same change in several accounts, propose it per agent and get a yes for each.

## Reading

- "Which deals were won this m

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: monitor-integrations
description: Help a CRM Connector customer see how their own integrations are doing. Use it when someone asks which integrations they have, whether they are running, what failed and why, what is waiting or what the latest syncs did, or wants one synced now, paused, resumed, or a conflict between two records resolved.
---

# Check your CRM Connector syncs

This belongs to part 2 of the plugin, **Integrations between two systems**: the integrations the person set up. The rules of an AI agent inside one system are listed with `list_automations` instead (part 1, AI Agents). These tools work on the person's own CRM Connector account. On first use ChatGPT asks them to connect it; the consent page shows what the assistant may see.

## Which integrations they have

- "Which integrations do I have?", "Is it running?", "When did it last sync?"
- Call `list_integrations`.
- Per integration: its name, the systems it connects, its status in plain words, its record types and when it last synced.

## What failed and why

- "What failed?", "Why did my invoices not arrive?", "What is waiting?"
- Call `get_integration_health`, for one integration when they name it.
- Summarise:
  - **failed**: grouped by reason and record type, each record counted once
  - **waiting**: records held until a related record arrives, for example an invoice waiting on its contact
- For each reason, say what usually fixes it in plain words, based on the reason the tool gives. If the reason is not clear, suggest opening the integration in CRM Connector, where the run details list each failed record with its reason.

## What the latest syncs did

- "What did the last sync do?", "Did anything get skipped?"
- Find the integration's id with `list_integrations`, ask which integration the person means unless they named it in this conversation, then call `get_integration_health` with that `integration_id` and `include` `recent_syncs`.
- Per sync: records read, written, skipped and failed, and why records were skipped.

## Acting on an integration

- "Sync it now", "Pause it", "Start it again": find the integration's id with `list_integrations`, ask which one when that is not clear yet (never pick one yourself), then `run_integration` (mode `changes`, or `full` to read and write every record again) or `set_integration_status` (`active` or `paused`).
- "Are records waiting for a choice?": `get_integration_health` with the `integration_id` and `include` `conflicts`. In a conflict two records match one record that can follow only one of them. For a person who allowed "Manage your integrations" it names the records and `resolve_integration_conflict` makes the choice (`sync` or `keep_apart`); for anyone else it only counts them and gives the link to the Conflicts tab in CRM Connector, where they are named.
- `run_integration`, `set_integration_status` and `resolve_integration_conflict` need "Manage your integrations" on the consent page. A read only member cannot be given it; point them to an owner or administrator of the account.

## Rules

- Keep the integration names as the tools give them.
- Only report what the tools return. Answers never contain contact details or amounts, and they name no customers or records except the conflict records `get_integration_health` names for a person who allowed "Manage your integrations"; do not ask for any of these.
- `run_integration`, `set_integration_status` and `resolve_integration_conflict` change something, so ask the person to confirm first: say what the tool will do before calling it. No tool creates or deletes an integration or a connection, and no tool fixes a record itself; point to the CRM Connector app for that.
- If a tool says the account has no active plan, pass on its sentence and link exactly as given. Do not discuss prices, plans, trials or discounts.
- Never ask for passwords, API keys or tokens.

View saved version →

---
name: plan-an-ai-agent
description: Answer questions about CRM Connector AI Agents before anything is set up. Use it when a person asks whether ChatGPT can work with the customers, deals, invoices or quotes in their own CRM or accounting system, what an AI agent can do in a particular system, which systems have an AI agent, or what the difference between AI Analyst and AI Agent is.
---

# Explore what an AI agent can do

This belongs to part 1 of the plugin, **AI Agents inside one system**. An AI agent works with the records of one of the person's own systems, right here in the chat: it reads their customers, deals, invoices and quotes, and when they allow it, it changes records and keeps automations running in that system. None of these questions needs a CRM Connector account. Answer from the tools, then offer the next step.

## What AI Agents is

- "Can ChatGPT work with my CRM?", "Can you update my deals for me?", "Can you read my invoices?"
- Call `get_ai_agent_options` without a system. It explains AI Agents and names the systems that have an AI agent.
- Explain the two packages in plain words:
  - **AI Analyst** reads: it searches and reads records, counts and adds them up, and finds the same customer in the person's other connected systems.
  - **AI Agent** also changes records when the person asks: fields, stages, notes, tasks, activities, line items and links. Every change is shown first and only written after a yes; risky ones the person approves in CRM Connector. It can also keep automations running: fixed rules inside that system, approved once.
- Say what it never does and what waits for the customer: it never deletes a record, it records a payment only where the system allows it and after the customer approves it, and it does not sync between two systems. Syncing between two systems is an integration, part 2 of the plugin.
- Do not call `search_records` or other record tools for this: they work on an agent that is already set up.

## What an agent can do in one system

- "What can an AI agent do in my CRM?", "Can it move deals between stages?", "Can it add tasks?"
- Call `get_ai_agent_options` with the system. It lists per record type whether the agent can read it and change it, the actions it can take there, what it cannot do yet, and what its automations can use.
- Answer only from that list. When something the person wants is not in it, say so plainly and offer to request it with `send_request`.

## Several accounts

- One AI agent works in one account of a system: one GoHighLevel sub-account, one HubSpot portal, one QuickBooks Online company. Someone with several accounts, such as an agency with many sub-accounts, sets up one agent per account, each with its own place.
- In the chat they then name the account they mean, and the assistant can answer across accounts one agent at a time.

## Ideas to try

- When the person is unsure what to use it for, give a few examples that fit what the tool returned for their system, such as:
  - "Which deals did not move in the last two weeks?"
  - "Add a follow-up task to every open quote older than a week."
  - "Whenever a deal is won, add a kick-off task due in two days." (an automation, see the `automate-workflows` skill)
- If the tool answer carries automation ideas for that system, pass those on.

## Next step

- **Plan it**: ask what the agent should read and what it may change, then call `plan_ai_agent` and share the link it returns. It opens the setup in CRM Connector filled in, where the person signs in to their system. The plan is saved under AI Agents; nothing works until they finish it. With AI Agent, the plan also names two or three automations that fit and switches on the actions they need.
- **Back from the setup**: the setup page sends the person back here and asks them to say "done" (or ask them to, once the setup is saved). Then call `get_ai_agent_options` with the system to check that the agent is saved.
- **Test it**: before the agent is switched on

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: plan-an-integration
description: Turn an integration someone describes into a CRM Connector plan with a prefilled setup link. Use it when a person wants two business systems connected, for example "when a deal is won in HubSpot, make a draft invoice in QuickBooks Online" or "keep my Xero contacts in Pipedrive".
---

# Set up a sync with CRM Connector

This belongs to part 2 of the plugin, **Integrations between two systems**: an integration set up once that then keeps two systems in sync by itself. Work inside one system (reading, changing or automating its records) is part 1, AI Agents: `get_ai_agent_options` explains it.

CRM Connector keeps business systems in sync: contacts, invoices, quotes, deals, jobs and appointments travel between systems such as QuickBooks Online, Xero, Jobber, HubSpot, Pipedrive and Salesforce. This skill turns a wish into a plan; the CRM Connector tools hold the facts.

## Steps

1. **Know the two systems and what should travel.** If either is unclear, ask one short question, for example "Which system do the deals start in, and where should the invoices end up?" Never guess a system.
2. **Check what is possible.** Call `get_integration_options` with both systems. Use what it returns: the record types, the direction (one way, or both ways for the record types it marks), the moments a record can wait for (such as when paid or when accepted) and the filters.
3. **Make the plan.** Call `plan_integration` with:
   - the source system and the target system
   - the record type keys `get_integration_options` returned
   - the trigger, when the person asked for one
   - `direction` `both_ways` when changes made in either system should reach the other; leave it out for one way
   When they change their mind, call `plan_integration` again: that saves a new concept with its own link and leaves the earlier one as it is, so share the newest link.
4. **Share the link and what happens next.**
   - Share the setup link from the plan as a link.
   - Say the plan is saved as a concept: nothing syncs yet, and they find it again under Integrations in CRM Connector.
   - They open it, sign in or create a CRM Connector account, connect both systems and review every choice before anything syncs.
   - Pass on the plan's notes, for example that contacts travel along, that a sync from date is needed, or which record types stay one way when both ways was asked.

## Spreadsheets (Google Sheets, an Excel or CSV file)

- A spreadsheet only sends: records go from the sheet into the other system and nothing is written back.
- Only our template is ever used, so nothing is matched. Call `get_integration_options` with the spreadsheet and the other system, or `get_connection_guide` with `other_system`: its `sheet` part names the template's tabs and columns and holds its download link.
- Then `plan_integration`. Its link asks only to connect: Google and the other system for Google Sheets, only the other system for an Excel or CSV file. The integration is saved at once, with our template made in their Google Drive or waiting to be uploaded. On the page it lands on they paste their rows (or upload the filled file), test it (nothing is written) and switch it on.
- With a sheet of their own, offer to copy its rows into the template here first: ask them to share it, and hand back an .xlsx with the template's tabs and exact headers, one row per record. They paste those rows into the Google sheet, or upload the file. A sheet that is not our template is refused.
- For a spreadsheet, `get_integration_fields` names each field by the column of our template.

## When something is not offered

- Say so plainly and share the request an integration link the tool gives.
- When a tool says the other direction is possible, offer that instead.

## Rules

- Only describe what the tools return. Never promise a record type, a direction, a trigger or a system the tools did not confirm.
- No tool creates the integration itself: the person creates i

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: set-up-a-sync
description: Turn an integration someone describes into a CRM Connector plan with a prefilled setup link. Use it when a person wants two business systems connected, for example "when a deal is won in HubSpot, make a draft invoice in QuickBooks Online" or "keep my Xero contacts in Pipedrive".
---

# Set up a sync with CRM Connector

This belongs to part 2 of the plugin, **Integrations between two systems**: an integration set up once that then keeps two systems in sync by itself. Work inside one system (reading, changing or automating its records) is part 1, AI Agents: `get_ai_agents_info` explains it.

CRM Connector keeps business systems in sync: contacts, invoices, quotes, deals, jobs and appointments travel between systems such as QuickBooks Online, Xero, Jobber, HubSpot, Pipedrive and Salesforce. This skill turns a wish into a plan; the CRM Connector tools hold the facts.

## Steps

1. **Know the two systems and what should travel.** If either is unclear, ask one short question, for example "Which system do the deals start in, and where should the invoices end up?" Never guess a system.
2. **Check what is possible.** Call `find_sync_options` with both systems. Use what it returns: the record types, the direction (one way, or both ways for the record types it marks), the moments a record can wait for (such as when paid or when accepted) and the filters.
3. **Make the plan.** Call `plan_integration` with:
   - the source system and the target system
   - the record type keys `find_sync_options` returned
   - the trigger, when the person asked for one
   - `direction` `both_ways` when changes made in either system should reach the other; leave it out for one way
   When they change their mind, call `plan_integration` again: that saves a new concept with its own link and leaves the earlier one as it is, so share the newest link.
4. **Share the link and what happens next.**
   - Share the setup link from the plan as a link.
   - Say the plan is saved as a concept: nothing syncs yet, and they find it again under Integrations in CRM Connector.
   - They open it, sign in or create a CRM Connector account, connect both systems and review every choice before anything syncs.
   - Pass on the plan's notes, for example that contacts travel along, that a sync from date is needed, or which record types stay one way when both ways was asked.

## Spreadsheets (Google Sheets, an Excel or CSV file)

- A spreadsheet only sends: records go from the sheet into the other system and nothing is written back.
- Call `find_sync_options` with the spreadsheet and the other system, or `get_connection_guide` with `other_system`. Its `sheet` part holds our template made for that system. Recommend it first, because its columns match by themselves: share the template download link, name the tabs and the required columns, and pass on the steps for using it.
- With a sheet of their own, they match its columns to the fields of the other system in the setup; pass on the tool's sentence about it.
- For a spreadsheet, `get_field_details` names each field by the column of our template.

## When something is not offered

- Say so plainly and share the request an integration link the tool gives.
- When a tool says the other direction is possible, offer that instead.

## Rules

- Only describe what the tools return. Never promise a record type, a direction, a trigger or a system the tools did not confirm.
- No tool creates the integration itself: the person creates it in CRM Connector from the setup link, after reviewing every choice. No tool deletes an integration or a connection.
- Do not discuss prices, plans, trials or discounts. If a tool says the account has no active plan, pass on its sentence and link exactly as given.
- Never ask for passwords, API keys or tokens. Systems are connected inside the CRM Connector app, never in the conversation.

## Test before committing

Offer a test when

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: work-with-my-records
description: Work with the records of a business system the customer connected to AI Agents in CRM Connector. Use it when someone asks about their own customers, deals, invoices or quotes in such a system, asks to update, tag or note them, or asks whether ChatGPT can work with the records of a system they use.
---

# Work with your records through AI Agents

This belongs to part 1 of the plugin, **AI Agents inside one system**. With AI Agents a CRM Connector customer connects one of their own systems to the CRM Connector MCP server and the assistant works with its records: it reads their customer data and, with AI Agent, changes records when they ask and keeps automations running (see the `automate-my-system` skill). Nothing in AI Agents syncs records between two systems: that is an integration, part 2 of the plugin (`find_sync_options`, `plan_integration`). `get_ai_agents_info` lists the systems an agent works in. The customer signs in to their system in CRM Connector, which needs no subscription, and the agent starts working once its package is subscribed to. The customer selects per system the record types the assistant may work with, each one read or read and change. Reading is the AI Analyst package; changing needs the AI Agent package and the customer's permission on the consent page.

## Start here

- Call `get_ai_agents_info` first; with `system` it also lists exactly what an agent can do in that system (per record type, its actions, what it cannot do and what its automations can use), so use that instead of guessing when someone asks what is possible. It names the connected systems, their package (AI Analyst reads, AI Agent also changes records) and per record type what is allowed. Every other record tool takes the system id it returns.
- Always ask which AI agent the person means before you use a record tool, unless they named it in this conversation; when there is only one, name it and check. Never pick one yourself.
- If no system is connected, offer to plan one with `plan_ai_agent`: ask what the assistant should read and what it may change, then share the link it returns, which opens the setup in CRM Connector filled in. Every plan is saved as a concept under AI Agents, so nothing works until they finish it; if they change the plan, call it again and share the newest link. Never name a system as available for AI Agents unless a tool answer names it. Do not discuss prices, fees, plans or trials.
- It also works without a sign in: it then explains both packages and the systems it works with, and says the person's own AI agents are not shown. If they already have one, `search_records` asks them to sign in.
- For a system without an AI agent yet, offer `send_request` with kind `ai_access`: the system, `read` (AI Analyst) or `read_write` (AI Agent), and in the details what the assistant should do there. Show what will be sent and send it only after the person confirms. The form at https://crm-connector.com/platform/ai-access#request does the same. Requesting is free, and CRM Connector then builds it for them.

## Several agents in one system

- Each account in a system is its own AI agent, named after that account: a sub-account in GoHighLevel, a portal in HubSpot, a company in QuickBooks Online, an organisation in Xero. An agency or a group with several accounts has several agents.
- `get_ai_agents_info` lists them by name. Use the name the person gives ("in Smith Plumbing") as the `system` argument; when they name none and there are several, list the names and ask.
- A question across accounts ("compare the open deals of Downtown and Uptown") is answered one agent at a time: run the same search on each named agent, then put the answers side by side. Say per figure which account it came from.
- A change is always proposed on one agent; for the same change in several accounts, propose it per agent and get a yes for each.

## Reading

- "Which deals were won this 

Preview of the first 4,000 characters. Read full instructions →