Integration · Payroll & HR

Connect Claude & ChatGPT to Open Badge Factory

Ask your AI to issue a badge to a group of course participants, go through pending badge applications, or check who received a badge in Open Badge Factory. It can list badges and earnable badges, read applications with the applicant's answers, approve or reject them, issue badges by email and revoke them from an issuing event.

Connect Open Badge Factory free

Free plan, no credit card. Takes about a minute.

Try asking

“Which badge applications are waiting for review?”
The AI searches badge applications by status and lists the pending ones.
“Show me what Maria answered in her application for the First Aid badge.”
It reads the application, including the applicant's answers.
“Approve her application and add a short congratulations.”
It approves the application, which issues the badge, and can include your email message.

What your AI can do

Badges

List badges and drafts, and read a badge's name, description, criteria and languages.

Applications

Search, read, approve and reject applications for earnable badges, with an optional email to the applicant.

Issuing and revoking

Issue badges to a list of recipients, look up issuing events and recipients, and revoke badges.

“Issue the Workshop Facilitator badge to these five people.”
It finds the badge and issues it to the recipients by name and email. They get a notification email unless you turn that off.
“Who received the Safety Training badge this spring?”
It searches badge recipients by badge and time range.
“Revoke the badge from the March issuing event for one participant who left the course.”
It revokes the badge for that email address in the event. Revoked badges are no longer valid.

27 tools for Open Badge Factory

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

approve_badge_applicationVisible to othersApprove a badge application by `earnable_id` and `application_id`, which issues the badge to the applicant. Optional `reviewer`, `send_email` and `email_message`.
delete_badgeDeletesPermanently delete a badge by badge id. Destructive action; may require approval. API summary: Delete badge.
delete_earnablebadgeDeletesPermanently delete a earnablebadge by application id. Destructive action; may require approval. API summary: Delete pending or rejected earnable badge application by id.
delete_evidenceDeletesPermanently delete a evidence by assertion id. Destructive action; may require approval. API summary: Delete evidence for a single issued badge assertion.
get_badgeGet one badge by `badge_id`, including its name, description, criteria and languages.
get_badge_applicationGet one badge application by `earnable_id` and `application_id`, including the applicant's answers.
get_badge_imageGet one image for a badge by badge id. API summary: Get single badge image.
get_earnable_badgeGet one earnable badge by `earnable_id`, including its application form.
get_evidenceGet one evidence by assertion id. API summary: Get evidence for single issued badge assertion.
get_issuing_eventGet one issuing event by `event_id`, including the badge and recipients.
get_organisationGet your Open Badge Factory organisation's details.
get_revisionGet one revision by revision id. API summary: Get a revision for an earnable badge application by id.
issue_badgeVisible to othersIssue a badge to people. Pass `badge_id`, `recipient` (list of objects with email and name) and `api_consumer_id` (a free label for the issuing app, e.g. my-example-app); optional `send_email`, `email_message`, `issued_on` and `expires_on` (Unix timestamps). Sends notification emails to recipients unless `send_email` is false.
list_badge_imagesList images for a badge. Optional filters: thumbnail. Results are paginated. API summary: Get all badge images. The resulting image data should be cached by the API client.
list_badgesList the badges in your organisation, optionally only drafts or non-drafts with `draft`, paged with `limit` and `offset`.
list_customer_aliasesList aliases for a customer. API summary: Get list of client aliases (sub-organisations).
list_customer_pingsList pings for a customer. API summary: API connection test.
list_earnable_badgesList earnable badges (badges people can apply for), filtered by `badge_id`, `draft` or `visible`.
list_event_evidenceList evidence for a event. API summary: Get evidence for single issuing event.
list_issuing_eventsList badge issuing events, filtered by `badge_id`, `email`, `event_name` or time range (`begin`/`end` Unix timestamps), paged with `limit` and `offset`.
reject_badge_applicationVisible to othersReject a badge application by `earnable_id` and `application_id`. Set `reject_reply` with `email_subject` and `email_body` to email the applicant.
revoke_badgeVisible to othersRevoke a badge from recipients of an issuing event. Pass `event_id` and `recipient` (list of email addresses). Revoked badges are no longer valid.
search_badge_applicationsSearch applications for earnable badges, filtered by `status`, `email`, `earnable_id` or `category`, paged with `limit` and `offset`. Use to find pending applications.
search_badge_recipientsSearch people who received badges, filtered by `email`, `badge_id`, `event_id` or time range, paged with `limit` and `offset`.
update_badgeChanges dataUpdate an existing badge identified by client id. API summary: Create a new badge.
update_earnablebadge_revisesVisible to othersUpdate an existing revise identified by application id. Has effects visible outside this system. API summary: Send earnable badge application back to applicant for revision.
update_evidenceChanges dataUpdate an existing evidence identified by assertion id. API summary: Add evidence for single issued badge assertion. New evidence will be added to the existing list.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Open Badge Factory from the app list.
2
Paste your key
Enter your Organisation ID as the client ID, your client secret, and your Organisation ID again in the last field. In Open Badge Factory, open Admin tools > API and generate a client secret. HeyMyApps uses them to get access tokens, so there is no separate sign-in.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Open Badge Factory?

The AI can read your organisation, badges, earnable badges, badge applications, issuing events and badge recipients. It can issue badges, approve or reject badge applications and revoke badges from recipients of an issuing event.

Does the AI see my Open Badge Factory credentials?

No. Your Open Badge Factory credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Issuing, approving, rejecting and revoking badges affect real people and can send them emails, so they can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

Open Badge Factory connects with OAuth, and OAuth connections need the HeyMyApps Pro plan or above. HeyMyApps also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Open Badge Factory account.

Why do I enter the Organisation ID twice?

Open Badge Factory uses your organisation ID as the client ID for API access. HeyMyApps also needs it as the Organisation ID, so it goes in both fields, together with the client secret you generate under Admin tools > API.