AI assistants and command line

Updated on 12 November 2026

Charcal connects to AI assistants that use MCP (Model Context Protocol) and has a command line for the Mac. Both work on the tasks in your account, the same ones you see in the app. Calendar events stay on your devices.

First: your personal token

You need an account. In the app open Settings, Account, and under API token tap Show personal token, then copy it: it starts with chc_.

The token can read and change your tasks, so keep it like a password and don't paste it where others can see it. If you think someone else has it, tap Regenerate token in the same section: the old one stops working right away.

In the commands on this page, replace chc_YOUR_TOKEN with your token.

AI assistants

The Charcal MCP address:

https://charcal.charstudio.app/mcp

The assistant can:

• read Today, Upcoming, Inbox and completed tasks, also by day, label or words;
• add a task with day, time, duration, deadline, label, priority, repeat and subtasks;
• move it, rename it, change its label or priority;
• check it off, reopen it or delete it;
• read your labels. New labels are created in the app only.

Claude Code

claude mcp add --transport http charcal https://charcal.charstudio.app/mcp --header "Authorization: Bearer chc_YOUR_TOKEN"

Cursor, VS Code and other clients that accept headers

Add an HTTP MCP server with the address above and the header Authorization: Bearer chc_YOUR_TOKEN. In Cursor it goes in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "charcal": {
      "url": "https://charcal.charstudio.app/mcp",
      "headers": { "Authorization": "Bearer chc_YOUR_TOKEN" }
    }
  }
}

Claude and ChatGPT, on the web or in the app

Their connectors only ask for an address. Use the one with the token at the end:

https://charcal.charstudio.app/mcp/chc_YOUR_TOKEN

In Claude, add it from Settings, Connectors, Add custom connector. ChatGPT needs developer mode: there you create a connector with this address and no authentication. This address is worth as much as the token, so don't share it.

Then try writing to the assistant: "What's on tomorrow?", "Add dentist on Friday at 10 with the personal label", "Move the gym to Thursday".

Command line

For the Mac, with macOS 15 or later, on Apple silicon or Intel.

brew install carpaaaaa/charcal/charcal

Then save your token:

charcal token chc_YOUR_TOKEN

The commands:

• charcal today: what's on today, overdue tasks included. Also charcal tomorrow, charcal inbox, charcal upcoming and charcal day 2026-12-24.
• charcal add "tomorrow at 8 dentist #personal": adds a task written the way you'd say it. Several at once with "then".
• charcal done dentist: checks off the task with that name, or with that id.
• charcal delete dentist: deletes it.
• charcal labels: your labels.
• charcal parse "meeting every first Monday of the month": shows how it reads the sentence, without touching your account.
• charcal help: every command.

The command line reads sentences like the app does, in English or Italian. It starts with your account's language; charcal language it changes it. With --json every list comes out as JSON, handy for scripts and agents.