> ## Documentation Index
> Fetch the complete documentation index at: https://docs.a-char.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT connector

> Add A-Char to ChatGPT and handle time off in plain language: check balances, book leave, move it, cancel it and approve your team's requests.

The A-Char connector lets ChatGPT work with your time off directly. Ask *"How many vacation days do I have
left?"* or *"Book the week before Christmas"* and ChatGPT reads your balances, works out the days, and files
the request in A-Char for you.

You sign in with your A-Char account. There is no API key to create, and ChatGPT can only do what you
could do yourself in A-Char.

## What you can ask

| Ask ChatGPT | What happens |
| - | - |
| *How many vacation days do I have left this year?* | Reads your balance for every policy you are on |
| *Book 21–24 December as annual leave.* | Previews the request, shows how many days it costs, then books it and notifies your approvers |
| *How many days would a week off in August take?* | Previews without booking, with weekends and public holidays left out |
| *Move my Friday off to next Monday.* | Updates the request; it goes back to your approvers |
| *Cancel my leave next week.* | Cancels it and returns the days to your balance |
| *What's the status of my requests?* | Lists your requests with each approver's decision |
| *Download the approval for my summer leave.* | Returns the generated approval document |

Approvers can also approve and decline from ChatGPT. ChatGPT cannot yet list the requests waiting for you,
so give it the request's ID.

ChatGPT understands Bulgarian too. *"Колко дни отпуска ми остават?"* works the same way.

> [!TIP]
>
> Ask ChatGPT to preview before booking: *"How many days would 3–14 August cost? Don't book it yet."* It
> shows the counted days and the balance left, and you confirm in the next message.

## Before you start

You need:

* **An A-Char account** in the organization whose data you want to use.
* **A ChatGPT account.** Once connected, the connector works on the web, in the desktop apps and on your phone.
* **On Business, Enterprise and Edu**, a workspace admin may need to allow the connector first. See the second
  tab below.

## Connect A-Char

**Personal plans**

**1. Find A-Char**

In ChatGPT, open **Settings → Apps** (or the app directory) and search for **A-Char**.

**2. Sign in to A-Char**

Click **Connect**. A browser window opens on the A-Char sign-in page. Sign in with your usual
account.

**3. Approve access**

Review the access ChatGPT asks for and click **Allow**. You return to ChatGPT and the connector
shows as connected.

**Business, Enterprise and Edu**

A workspace admin allows the connector first, then each person connects their own A-Char account.

**1. Admin: allow the connector**

Open **Workspace settings → Apps**, find **A-Char** in the directory and enable it for the workspace.
Enabling it does not give anyone access to A-Char data; each person still signs in as themselves.

**2. Everyone: connect your account**

Open **Settings → Apps**, find **A-Char** and click **Connect**.

**3. Sign in and approve**

Sign in to A-Char in the window that opens, review the access, and click **Allow**.

### Use it in a chat

Type **@A-Char** at the start of your message, or pick **A-Char** from the **+** menu, then ask a
question, for example *"What's my time-off balance?"*.

> [!TIP]
>
> If ChatGPT answers with your actual policies and numbers, the connector is working.

### What ChatGPT asks before doing

Every A-Char tool tells ChatGPT what kind of action it is, and ChatGPT asks for your confirmation before
anything that changes your data.

| Tools | Kind |
| - | - |
| `get_time_off_balances`, `list_my_time_off`, `preview_time_off`, `get_time_off_document` | Read only. They change nothing |
| `request_time_off` | Creates a request and notifies your approvers |
| `update_time_off`, `cancel_time_off`, `approve_time_off`, `decline_time_off` | Destructive. They change or end an existing request, or notify someone in a way that cannot be taken back |

None of the tools reach outside your A-Char organization.

## What ChatGPT can see and do

The connector acts **as you**, with your current role in A-Char, in one organization. It goes through the same
rules as the dashboard.

| You are | ChatGPT can |
| - | - |
| **An employee** | Read your balances and requests, preview, book, change and cancel your own time off, and download its documents |
| **An approver** | Also approve or decline requests that are waiting on you, and read the balances and requests of the people whose requests you approve |
| **An admin** | Also act on anyone's time off, approve or decline in place of the approver whose turn it is, and cancel leave that has already started |

Some things ChatGPT cannot do, because A-Char does not allow them for anyone:

* Approve or decline your own request.
* Book leave that overdraws a fixed balance, misses the policy's notice period, or overlaps another
  request. ChatGPT gets the same message you would see in A-Char and explains it.
* See another organization's data.

## Privacy and security

* **Your data only goes where you ask.** ChatGPT calls A-Char only when a question needs it. The results
  become part of that conversation.
* **Review before it acts.** Read the dates in ChatGPT's confirmation before you approve a booking,
  change or cancellation.
* **Check the answer.** ChatGPT can misread a date or a policy name. For anything that matters, confirm
  the result in A-Char.
* **Know your ChatGPT data settings.** How OpenAI stores and uses conversations is set by your ChatGPT
  plan and data controls, not by A-Char.

How A-Char handles your data is described in our [privacy policy](https://a-char.com/en/privacy).

### Disconnect

Open **Settings → Apps → A-Char** and click **Disconnect**. ChatGPT can no longer reach A-Char until you
connect again. A workspace admin can remove the connector for everyone from **Workspace settings → Apps**.

## Troubleshooting

> **Sign-in finishes, but the connector won't connect**
>
> This happens when your A-Char account belongs to **more than one organization**: the connector cannot yet
> tell which one you mean. Use the [MCP server](https://docs.a-char.com/mcp/overview.md) with an API key, which is created inside a
> single organization, until organization choice is added to sign-in.

> **ChatGPT doesn't use A-Char**
>
> Mention it directly: start your message with **@A-Char**, or pick it from the **+** menu.

> **ChatGPT says it isn't allowed to do something**
>
> The action is outside your role in A-Char: someone else's time off when you are not their approver, a
> request that is not waiting on you, or cancelling leave that has already started. Ask an admin, or do
> it as the right person.

> **A policy I expect is missing**
>
> ChatGPT only sees **active** policies you are assigned to. If a policy is missing in A-Char too, ask
> your HR admin to assign it. Policy names are set by your company, so use the name you see in A-Char.

> **It stopped working after it used to work**
>
> Your access may have been revoked, your role may have changed, or you may have left the organization.
> Disconnect and connect again. If it still fails, check with your A-Char admin.

## Support

Write to [service@sparxup.com](mailto:service@sparxup.com) with what you asked ChatGPT and the answer you
got. Leave out personal details you don't need to share.

## Related

* [MCP server](https://docs.a-char.com/mcp/overview.md): the server behind the connector, every tool, and setup for other clients.
* [Claude connector](https://docs.a-char.com/claude-connector.md): the same tools in Claude.
* [Authentication](https://docs.a-char.com/authentication.md): roles, scopes and what a credential may do.
* [Privacy policy](https://a-char.com/en/privacy)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.