Charitable Documentation

Learn how to make the most of Charitable with clear, step-by-step instructions.

Getting started with AI assistants

Requires the Charitable Pro plugin 1.8.18 or later, and WordPress 6.9 or later.

Charitable can now be operated by an AI assistant. You connect an assistant such as Claude or ChatGPT to your site, then ask for what you want in plain English, and the assistant does the work in Charitable for you.

“Set up a fundraiser for the animal shelter with a $5,000 goal.” “Who are our biggest supporters?” “Someone posted a check for $250, record it.”

ask chatgpt to build a campaign in charitable

What’s in This Guide

There is nothing to install in Charitable. If you are running 1.8.18 on WordPress 6.9 or later, the operations are already registered and waiting for a client to connect. The one Charitable setting you will touch is write access, in step 4.

The Charitable Tools AI MCP screen headed Use Charitable With Your Favorite AI, listing what Charitable can do with AI across campaigns, donations and donors, and reports, with write access switched off

For more detailed documentation, everything about Charitable + AI is here »

What You Need

  1. WordPress 6.9 or later. This is built on the WordPress Abilities API, which arrived in 6.9. On 6.8 or earlier nothing registers and nothing about your site changes.
  2. The Charitable Pro plugin, version 1.8.18 or later.
  3. An assistant that can connect to WordPress. Assistants reach your site through a connector, and the standard for this is called MCP. WPVibe, built by SeedProd, is one such connector and works with Charitable out of the box. Any client that reads the WordPress Abilities API will see Charitable’s operations the same way.
  4. An administrator account on your site, or one with the Charitable capabilities for the work you want done. The assistant acts as whoever you connect it as, so read What It Can and Cannot Touch below.
  5. Nothing else. An assistant starts out able to read but not change anything. Turning writing on is step 4, and it is a deliberate, separate decision.

You do not need a Charitable addon for this, and you do not need to paste an API key into Charitable’s settings.

Step 1: Add the Connector to Your Assistant

This varies by client, so follow your connector’s own instructions. For most, you add it once to your account and it is then available wherever you are signed in.

In ChatGPT, for example, WPVibe is a listed app. You will find it under Plugins, and you choose “Install plugin” and sign in.

The WPVibe app page in ChatGPT's plugin directory, described as AI WordPress tools by SeedProd, with an Install plugin button

Note: In Claude, Claude Code, Cursor, and Windsurf, you add the connector by its MCP server address instead. Your connector will show you the address to use.

Step 2: Create an Application Password

An application password is how WordPress lets a program sign in as you without your real password. It is built into WordPress and you can revoke it at any time.

  1. In your WordPress dashboard, go to Users » Profile.
  2. Scroll to Application Passwords.
  3. Type a name you will recognize later. The name of your assistant is a good choice.
  4. Click “Add New Application Password”.
  5. Copy the password now. WordPress shows it once and cannot show it again. If you lose it, delete the entry and create another.
application password

Keep it to yourself. An application password acts as your user account, so anything done with it appears in your dashboard authored by you.

Pro tip: If several people use assistants on one site, give each person their own application password. The Abilities log will then show you who did what.

Important Note: The Application Passwords section only appears on sites served over HTTPS. If your site is not on HTTPS yet, that is the thing to fix first.

Step 3: Connect Your Site

Tell your assistant to connect your site, and give it the address, your username and the application password.

Most connectors will also offer to hand you a one-click approval link instead, so you never type the password at all. Take that route if it is offered.

Once the site is connected, Charitable » Tools » AI MCP will confirm it.

Step 4: Turn On Write Access

A newly connected assistant can read, but not change anything. That is deliberate. Connecting is a safe act on its own, and you decide separately whether an assistant may create campaigns, record donations or publish anything.

Until you turn writing on, an assistant can answer every question about your fundraising, such as what you raised, who your biggest supporters are, and what a campaign looks like. It will refuse to change anything, and explain what to switch on.

  1. Go to Charitable » Tools » AI MCP.
  2. Turn on “Enable AI Write Access”.
enable write access

That is the whole step, and it saves as you click. Turn it back off whenever you like.

Reads keep working either way, and anything an assistant changes is recorded under Charitable » Tools » Logs so you can always see what happened.

Note: Leaving write access off is a perfectly good way to use this. A read-only assistant is genuinely useful for reporting and answering questions, and it cannot alter a single campaign.

Step 5: Check It Worked

Ask 2 questions.

“What WordPress sites do I have connected?” Your site should come back by name.

“What can my Charitable site do?” You will see the operations grouped the way the plugin is, covering your plugin, site and payment gateway status, then campaigns, donations, donors and reports.

An assistant listing everything Charitable can do, grouped into site and configuration, campaigns, donation forms, campaign design, donations, donors, and reporting and analytics, ending with a note that it only discovered the abilities and changed nothing on the site

In 1.8.18 that is 29 operations, split as 3 that report your plugin, site and payment gateway status, 14 for campaigns, 4 for donations, 3 for donors and 5 for reports. The number grows as we add to Charitable, so treat it as a sign the connection is working rather than a fixed figure.

Important Note: If the site connects but you see no Charitable operations at all, the connection is fine and something else is wrong. Check that WordPress is 6.9 or later and the Charitable Pro plugin is 1.8.18 or later.

Try These First

Ask in your own words. You never need to name an operation or fill in a form, because working out which one to use is the assistant’s job.

These all work whether or not you turned on write access, except where noted.

  • “Set up a fundraiser for the animal shelter, $5,000 goal, ending at the end of next month.” Needs write access. You get a real campaign built in the Campaign Builder, with a template’s layout and colors and a ladder of suggested donation amounts scaled to your goal, not an empty draft.
  • “Add a question to that form asking how they heard about us.” Needs write access.
  • “Make the donate button green.” Needs write access.
  • “Who are our biggest supporters?” Ranked over your whole history, which is what that question usually means. Ask for a period if you want one.
  • “Which campaign has raised the most?”
  • “Someone posted a check for $250 from Jane Smith, record it.” Needs write access. It will ask you for the donor’s email address, and it should, because donors are matched on their email. Inventing one would split or merge real donor records.
  • “Why aren’t my donations showing up?” It can read your gateway and test-mode status and give you a real answer.

Pro tip: Say the period in your own words. “Last quarter” and “this month” are turned into real dates in your site’s own timezone, so you get the period you meant rather than a running total of everything you have ever raised.

What It Can and Cannot Touch

Nothing is exposed to anyone who could not already do it in the dashboard. Every operation checks a Charitable capability before it runs, so an assistant connected as a Campaign Manager can do less than one connected as an administrator.

A few limits are useful to know up front:

  • Changes are off until you turn them on. A connected assistant reads immediately and cannot change anything until an administrator enables write access under Charitable » Tools » AI MCP. This sits on top of the permission checks, not instead of them.
  • Payment credentials are never readable. Your Stripe, PayPal and Square keys are not included in anything an assistant can see, whoever is asking.
  • Donor lists never include email or postal addresses. Reading a named donor’s contact details requires the sensitive-data capability, so one permitted read cannot become a bulk export of your donor file.
  • There is no permanent delete for a campaign. Deleting one would orphan the donation records that point at it, so an assistant can move a campaign to the trash, which is reversible, and nothing more. It will also refuse to trash a campaign that already has donations unless you confirm.

Keeping an Eye on It

Two places in your dashboard:

The Abilities Log

Go to Charitable » Tools » Logs, set the first drop-down to Abilities and click “Filter”.

Every change an assistant makes is recorded here, with what it did, when, and which operation it used. Refusals are recorded too, so you can see the times an assistant tried something and was stopped.

The Charitable Tools Logs screen with the filter set to Abilities, listing donation form changes an assistant made, each with its message, level, source and date

Pro tip: Use “Export Filtered (CSV)” on that screen if you need to hand the record to someone else.

The Abilities API Section of System Info

Charitable » Tools » System Info has an Abilities API section, and it is the first place to look if a client connects but cannot see your data.

It tells you whether the API is available, how many Charitable operations are registered and how many of those can write, whether write access is on, which MCP clients are active, whether anything is blocking REST requests, and what the last operation and the last refusal were.

The Abilities API section of the Charitable Tools System Info screen, listing whether the API is available, how many Charitable abilities are registered, whether AI write access is enabled, which MCP clients are active, and the last ability invoked and last refusal

Pro tip: Click “Copy System Information” and paste it into a support ticket. It saves a round of questions.

FAQs on AI Assistants in Charitable

Do I need to pay for a second AI subscription?

No. This works with the assistant you already use, and Charitable does not add an AI subscription of its own.

Can an assistant publish a campaign without me seeing it?

Not unless you have turned write access on and asked it to. Campaigns it creates arrive as drafts, so a person still decides what goes live.

Can an assistant delete my campaigns?

It can move a campaign to the trash, which you can undo. There is no operation that deletes a campaign permanently, and it will refuse to trash a campaign that already has donations unless you confirm.

Why does it keep asking me for a donor’s email address?

Because donors are matched on their email address rather than their name. Without it, a new record could be created for someone who has given before, or 2 different people could be merged.

How do I disconnect an assistant?

Turn “Enable AI Write Access” off to stop any changes straight away. To cut the connection entirely, revoke the application password under Users » Profile. Charitable keeps working normally either way.

I am on WordPress 6.8. What happens?

Nothing registers and nothing about your site changes. The Abilities API arrived in WordPress 6.9, so an assistant will connect to your site and find no Charitable operations at all.

That’s it! You’ve connected an AI assistant to Charitable.

Next, Everything AI Assistants Can Do in Charitable covers the full list of all 29 operations, how permissions map to roles, and what is deliberately out of reach.

Helpful Links

🤝 Get help when you need it

Connect with Customer Support →

📑 Find the guide you need

Browse the Documentation Hub →

⬇️ Download proven strategies, campaign ideas, and expert tools

Get the Fundraising Kit →

🔗 Let your AI Assistant do the fundraising work for you.

Connect Charitable to your AI assistant →

💸 Get Free Fundraising Resources
Head to the Charitable Fundraising Hub →

🤔 Got questions about Charitable?
Charitable FAQs →

Need help understanding non-profit terms and jargon?
See our Non-Profit Glossary →

Still have questions? We’re here to help!

Last Modified:

What's New In Charitable

View The Latest Updates
🔔 Subscribe to get our latest updates
📧 Subscribe to Emails

Email Subscription

Join our Newsletter

We won’t spam you. We only send an email when we think it will genuinely help you. Unsubscribe at any time!

ambassadors New

🖨️ Introducing Fliers and Posters: Raise Money Away From the Screen!

A lot of peer-to-peer fundraising happens away from a screen: at the finish line of a 5K, on a school noticeboard, in an office kitchen. Charitable Ambassadors 3.4.7 adds 2 printables, a fundraiser flier carrying each fundraiser’s own story and QR code, and a recruitment poster that signs new fundraisers up. Both open as a normal web page and print straight from the browser. Why this is important:

  • 🏁 A flier for every fundraiser: Each one carries that fundraiser’s own photo, story and goal, with a QR code that opens their page rather than your main campaign.
  • 📌 A poster that recruits: It shows “Now Recruiting” above your campaign name with a large QR code that opens your sign-up form, so someone can start fundraising without waiting on a link from you.
  • 🪄 No design tool needed: Both printables render as a normal web page and print from the browser, with no PDF plugin and no designer.
  • 📄 2 flier layouts: Hand out carries the full story for giving to friends and family, and Post up carries a short hook with 5 tear-off tabs for a noticeboard.
  • 🛡️ Off until you switch it on: Fliers stay off after the update until you enable them under Charitable » Ambassadors » Other » Fliers, and only the owner or an administrator can open one.

Check out our announcement here.

Improvement Payments

💸 Introducing Tiered Rates for Fee Relief: Match the Ask to the Gift!

Fee Relief asks your donors one short question at checkout: would you like to cover the processing fee on this gift? Until now that question used a single rate for every donation on a gateway, so a $10 gift and a $500 gift were asked for the same percentage. Fee Relief 1.3.0 lets you set as many donation bands as you like, each carrying its own rate. Why this is important:

  • 🪙 Gentler on small gifts: A fixed transaction cost is a far bigger share of a $10 donation than a $500 one, so bands let you ask for less at the bottom.
  • 🎚️ As many bands as you need: Each band carries its own percentage and its own fixed amount, and the top band runs on with no upper limit.
  • 🛑 An optional ceiling: A Maximum fee field stops any donor being asked for more than a number you choose, however large the gift.
  • 🔌 Set per payment gateway: Stripe can run on four bands while Windcave and Payfast stay on a single rate, because bands belong to a gateway and not to your whole site.
  • 🛡️ Nothing changes until you say so: Your current rates stay exactly as they are until you switch Use Tiered Rates on under Charitable » Settings » Advanced » Fee Relief.

Check out our announcement here.

Donations Improvement

📊 Your Pro Dashboard Can Now Compare, Export, and Score!

Most fundraising dashboards only tell you how much you have raised. Charitable Pro 1.8.19 rebuilds the dashboard and the Reports Overview around the harder questions: whether anything is broken, whether this period beat the last one, and which single change would make the most difference today. Why this is important:

  • 📈 Every figure has a trend: Pick a period and the tiles and the chart move together, with each total shown against the previous period.
  • 🗓️ Charts that stay readable: Short ranges group donations day by day, while longer ranges group by week or month, so a full year reads as a curve instead of a flat line.
  • 🔀 Compare any 2 periods: Not just consecutive ones, so you can ask how this December did against last December. That matters because fundraising is seasonal.
  • 📤 Export the whole summary: Send the full overview out as CSV or PDF, ready for a board pack or a funder report.
  • 🎯 Score your setup for free: Have your fundraising setup scored, so the one change worth making next is the one you can see.

Check out our announcement here.

Feature New

🎟️ Introducing Charitable Events: Sell Tickets Inside Your Campaigns!

Most nonprofits sell event tickets in one tool and collect donations in another, which leaves two sets of reports and a manual match at the end of the year. Charitable Events brings both together, selling tickets through the same donation forms and payment gateways you already run in Charitable. Why this is important:

  • 🎟️ Every ticket is a donation: Ticket sales run through the gateway you already use and count toward the campaign goal, with everything managed under Charitable » Events.
  • 📱 QR check-in from any phone: Each attendee gets their own QR code on the receipt, and volunteers scan at the door through a check-in link that needs no WordPress account.
  • 🧾 Receipts ready for tax time: Give each ticket type a fair market value, and Charitable puts the correct tax-deductible amount on every donor receipt.
  • 📋 Attendee details at checkout: Ask every guest for a meal choice, shirt size, or access needs, with a separate attendee record created for each ticket.
  • 🗓️ Blocks and calendars included: Three editor blocks plus Sugar Calendar and The Events Calendar support put your events where supporters already look.

Check out our announcement here.

ai New

🚀 Unleash AI Power in Charitable!

Your AI assistant can now build, edit, and manage your Charitable fundraising campaigns directly — just by asking. With Charitable Pro adding write support for the WordPress Abilities API, tools like ChatGPT, Claude, and Cursor can handle full administrative actions safely through MCP. Why this is important:

  • 🤖 Campaign creation in plain language: Prompt your assistant with a goal like “Set up a fundraiser for the shelter with a $5,000 goal”, and it builds a real draft campaign complete with suggested donation tiers.
  • 🎨 Instant donation form tweaks: Add custom fields, change button colors, or reorder elements without diving into form settings.
  • 📝 Offline gift logging: Tell your assistant about cash or check gifts, and it will match donor emails and record transactions into your history.
  • 🛡️ Safety and control by default: Write access stays strictly off until turned on in Charitable » Tools » AI MCP, keeping read-only reporting safe by default.
  • 📜 Full audit logging: Every change made by an AI assistant is tracked under Charitable » Tools » Logs, so you always know who (or what) updated your site.

Check out our announcement here.