Developers

Connect Chalk to Claude

Add Chalk to Claude as a custom connector, sign in with your Chalk login, choose what Claude can see and change, and disconnect it when you are done.

Updated By Adrian Gluchowski10 min read

On this page

The ChalkCRM connector lets Claude, Anthropic's AI assistant, read your shop and answer questions about it in your Claude chats. You choose which areas it can see. It changes things only if you turn on Let Claude make changes, it sends nothing to customers unless you turn on Send to customers, and it never moves money.

Chalk's address for Claude:

https://mcp.chalkcrm.com/mcp

An overview, with example questions, is on the Claude connector page.

What you need

  • Chalk on the AI plan ($99 a month), or the 14-day free trial. Core cannot connect.
  • To be the owner or an admin in Chalk, or a teammate whose role has Connect Claude (below).
  • Your own Claude account. Anthropic runs it and bills for it on its own. On Claude's Free plan you can add one custom connector.

The same address and steps are in Chalk under Settings > Connectors > Claude (teammates: Profile), with a Copy button and an Open Claude link.

Connect from Claude

  1. In Claude, open Customize, then Connectors.
  2. Select Add, then Add custom connector.
  3. Name it ChalkCRM, paste https://mcp.chalkcrm.com/mcp as the server address, and select Continue. Keep the sign-in options Claude marks Detected, then select Add.
  4. Select Connect on ChalkCRM. Claude sends you to Chalk.
  5. Sign in to Chalk the way you always do. Chalk shows your shop, who is signed in, and what Claude will see.
  6. Leave Let Claude make changes off for look only, or turn it on. To pick area by area, select Choose what Claude can see and change.
  7. Press Connect to Claude. Chalk may ask you to confirm it's you first.
  8. Back in Claude, open a chat, select +, then Connectors, and check that ChalkCRM is on.

On a Claude Team or Enterprise plan, members can't add a custom connector themselves. An Owner of your Claude organization adds it once under Organization settings > Connectors (Add, then hover over Custom and select Web) with the same address. Then each person finds ChalkCRM under Customize > Connectors, selects Connect, and signs in with their own Chalk login.

Claude's menus can move. If yours look different, Anthropic's help center has the current steps for adding a custom connector.

Claude connects to the shop you sign in to, and never shows records from any other shop.

What Claude can see and change

Each area has a switch to see and a switch to change. The first five start on for seeing. The other seven start off until you turn them on. Claude needs to see at least one area, and an area that is off is hidden everywhere, even on a client's or a job's record.

AreaSeeChange
ClientsContact details, properties, notes, tags, custom fields and historyAdd and change clients, properties, phone numbers and emails, notes, tags and custom fields; archive or restore a client or property
Leads and quotesLeads, the pipeline, quotes with lines, options and totals, the price book and quote templatesAdd and change leads, draft and edit quotes with every kind of line (tiers, add-ons, price book items), copy one, turn an approved quote into a job, archive or restore
Jobs and the scheduleJobs with totals, costs and crew pay, visits, calendar events, time off and checklists, your team's names and rolesChange, finish and reopen jobs, book, move and finish visits, move a rain day, fill in checklists, add calendar events and time off
InvoicesInvoices, payments, what is owed, payment plans and expensesDraft invoices, write down a cash or check payment by hand, void one written down by mistake, set payment plans and the card fee
Home screen numbers and reportsThe home screen numbers, reports, the books and goalsLook only
Pay and payrollTime sheets, pay weeks, who is owed what and each person's pay setupFix hours and clocks, change pay rates, add, fix and hold pay rows, log expenses (with Invoices changes on too), mark pay paid once you paid it some other way
InventoryStock, places, tools, what is running low and what each job usedAdd and change stock, write down what came in or moved, mark stock used on a job
MessagesText and email threads, and what is waiting to goSave a draft reply as a note for a person to use
Files and photosFiles and photos on recordsAdd small files and photos
Shop setupMessage wording, defaults and business detailsChange the price book, job types, stages, terms, forms, wording and defaults
AutomationsWhat each automation says and when it goesChange its words or wait, turn it off, pause them all
TeamWho is on the team, their role and sign-in status. Never payOnly with Team changes on (below)

Let Claude make changes turns on changes for clients, leads and quotes, and jobs and the schedule. Every other area's changes are their own switch, so writing down a payment (under Invoices) and pay (under Pay and payroll) stay off until you turn them on.

Two things work the same as in the app: finishing a job or its last visit, or turning a quote into a job, adds crew pay from your pay setup; and leads Claude adds still go to your own lead webhook (such as Zapier) and to Meta Conversions, if you set them up.

More permissions

Things that can't be fully undone have their own switch, off for every connection. Only the owner, an admin, or someone with Manage API keys and Claude turns one on, in the connection's Manage sheet. Each also needs changes on in its area.

  • Send to customers: send quotes, invoices, receipts, reminders, visit confirmations, on my way, lead follow-ups and texts or emails, share a customer's links, and turn on automations. You read a short note and press I understand first. A sent message can't be taken back. Claude sends at most 100 messages a connection a day; an automation Claude turns on then sends on its own, outside that count.
  • Archive invoices and jobs: archiving an invoice turns off its pay link for good.
  • Merge clients: a merge can't be undone.
  • Approve quotes by hand: an approval can't be taken back.
  • Cancel visits and calendar items: cancel visits or the rest of a job, and erase calendar events and time off. Customers are not told.
  • Edit sent invoices: change an invoice the customer already has. Nothing is sent to them.
  • Write-offs and bounced checks: both can be undone.
  • Lock pay weeks: lock or unlock a week's hours and pay.
  • Delete expenses: also deletes the purchase in QuickBooks, if connected. It can be restored.
  • Money rules: tax, the fees passed on, deposits, late fees, discounts and pricing rules.
  • Team changes: roles, what each role can do, turning teammates off or on, signing them out. Also needs I understand.
  • Tie quotes and jobs to leads: a tie can't be undone.

Guards

  • Can't undo: nothing that can't be undone happens unless its More permission is on.
  • Drafts only: Claude edits quotes and invoices only while they are drafts, unless Edit sent invoices is on.
  • Sending: nothing goes to customers because of Claude unless Send to customers is on. With it on, Chalk keeps your quiet hours, opt-outs and STOP, sends only to the customer's own number or email, stops at 100 messages a connection a day, and sends nothing while automations are paused. An automation Claude turns on then sends on its own, outside that count.
  • No money moves: Claude never charges cards, takes bank payments, refunds or pays anyone. A payment it writes down is cash or a check that already came in by hand, and marking pay paid only writes it down.
  • No deletes: it never deletes a client, quote, job, invoice, note or property. Every change goes in History. For notes, custom fields, settings, invoices, pay and the schedule, History also keeps what was there before.

It also never does more than the person who connected it can do in Chalk, or more than the shop lets Claude do. It can't change your plan, invite anyone, make API keys, change an owner or an admin, or run Payday for the whole team.

Manage it

  • Your connections: open Settings > Connectors > Claude. Press Manage on a connection to flip its areas, Let Claude make changes and More permissions, or to see its last calls. Start a new chat in Claude so its list of tools matches.
  • Teammates manage their own connections in Profile.
  • The whole shop: the owner and admins see everyone's connections there, and set what Claude may do in this shop.
  • Role switches: in Settings > Team, What each role can do has Connect Claude, Let Claude make changes and Manage API keys and Claude. All three start on for the owner and admins and off for everyone else. Turning off Connect Claude stops every connection that person made.

See what Claude did

Every change shows in Settings > History under the person who connected it, as via API key 'Claude'. What a note, custom field or setting said before is kept in full. Each message Claude sends goes in History too, and the owner, admins and the person who connected it get one Sent by Claude alert a day for each connection. In Claude, under Customize > Connectors, you can choose whether Claude asks before it uses a ChalkCRM tool (except in Research, so switch off write tools you don't want used there), and block any tool you don't want it to use.

Claude can misread a request or pick the wrong record. Read what it says it did, and check a draft before you send it.

Disconnect

  • In Chalk: press Disconnect on the connection. Chalk may ask you to confirm it's you. Claude's next call is refused.
  • In Claude: open Customize > Connectors and remove ChalkCRM. To close it on Chalk's side as well, also press Disconnect in Chalk.

Limits

  • Each connection can make 60 calls a minute and 5,000 a day, and send at most 100 messages a day. Past a limit, Claude is told to wait. An automation Claude turns on then sends on its own, outside that count.
  • Claude asks you to sign in to Chalk again about once a month. The new connection starts with More permissions off, so turn on any you use again.
  • Each person can keep up to 5 Claude connections. Connecting a sixth closes their oldest.
  • A connection nobody uses for 90 days closes by itself.
  • If the shop leaves the AI plan, the connection stops until it is back on it.

If something is off

  • ChalkCRM isn't in Claude's directory. Not yet. Add it as a custom connector with https://mcp.chalkcrm.com/mcp, as above.
  • Claude won't let you add a custom connector. On a Claude Team or Enterprise plan, ask an Owner of your Claude organization to add it under Organization settings > Connectors.
  • Chalk says your role can't connect Claude. Ask the owner or an admin to turn on Connect Claude for your role in Settings > Team.
  • Chalk says it needs the AI plan. The owner or an admin can switch plans under Settings > Billing. See plans and billing.
  • Claude says something is switched off. Turn on the area or More permission in Settings > Connectors > Claude, then start a new chat in Claude. The shop's own limits and your role can also keep an area off.
  • Claude says to do it in Chalk. Some things stay with a person, like a restore that could start automatic messages again, finishing a job while someone is clocked in on it, or starting paused automations again.
  • Claude asks you to connect again. Somebody pressed Disconnect, it went 90 days unused, a sixth one replaced it, it has been about 30 days since you connected, or the person who made it left the team. Connect it again from Customize > Connectors in Claude.
  • Claude says the connection stopped working. The shop is off the AI plan or the role lost Connect Claude. Fix that and it works again without reconnecting.

For anything else, email info@chalkcrm.com with what you asked and about when.

Your records and Anthropic

When you ask, Claude reads records from Chalk, and they become part of your Claude chat. Anthropic handles that chat under your own Claude account, its settings, and Anthropic's terms and privacy policy. Chalk never sees your chats. Its call log records Claude's changes and refusals, and a sample of its reads, like any API key's (the command, the result and the time) for 30 days, and the connector logs the tool, the shop, the result and the time. Neither keeps what you asked.

Good to know

  • The connector is not ChalkBot. ChalkBot is the assistant inside Chalk. Claude's calls do not use ChalkBot credits.
  • Developers who want their own scripts or tools can still make an API key. See connect a tool with an API key.