# Chartjuice docs

Chartjuice is a [free online chart maker](https://chartjuice.com/). You can use it without opening the editor: ask an AI assistant such as Claude for a chart, put a chart in an email as a picture that stays up to date, or make charts from your own code.

## What you can do

- [Ask an AI assistant for a chart](https://chartjuice.com/docs/#assistant): Connect Claude, ChatGPT or another assistant, then ask in plain words. It makes the chart, shows it to you and saves it to your account.
- [Put a live chart in an email or a doc](https://chartjuice.com/docs/#images): Copy an image link in the editor and paste it into an email, a Notion page or a website. The picture changes when you edit the chart.
- [Make charts from code](https://chartjuice.com/docs/#api): Send data from a script or a program and get back a saved chart or a picture of one.

Each of these needs a Chartjuice account, which is free. A chart that an assistant or your code makes is saved to your account like any other. You can open it in the editor and carry on by hand, and the assistant or your code sees your changes too.

## Connect Chartjuice to your AI assistant

An assistant reaches Chartjuice through a connector: a link between the assistant and another app, which you set up once. There is nothing to install and no code to write. Every assistant asks for the same thing, the address of Chartjuice:

```
https://chartjuice.com/mcp
```

In Claude, on the web or in the desktop app, it takes three steps.

1. Open Customize, then Connectors. Choose Add, then Add custom connector, and paste the address.
2. Claude sends you to Chartjuice. Sign in there, or make a free account.
3. Check that the page names Claude, and choose Allow.

Then start a chat and ask for a chart. [Connect an AI assistant](https://chartjuice.com/docs/mcp/) has each of these steps in full, the steps for ChatGPT, Claude Code, Cursor and VS Code, and what a connected assistant can and can't do.

### What to ask for

Ask the way you would ask a person. For example:

- "Make a bar chart from this data", with your rows pasted underneath.
- "Make it horizontal and sort it largest first."
- "Compare this year and last year as two lines, and make this year orange."
- "Is this pie chart easy to read? Fix what is not."
- "Show me the chart, and give me a link to it."

The assistant answers with the chart as a picture and a link that opens it in the editor.

## Put a live chart in an email or a Notion page

An image link is a web address that shows one of your saved charts as a picture. Paste it into an email, a Notion page or a website and the picture stays current: when you edit the chart, the picture changes with it. This takes no code either.

1. Open the chart in the editor.
2. Choose Download, then Copy image link.
3. Paste the link wherever a picture can be added by its web address.

[Chart images](https://chartjuice.com/docs/images/) goes through Notion and email, who can see a link, how views are counted and how to turn a link off.

## Use the API

This part is for people who write code. The API lets a program do what you do in the editor: make a chart from data, edit it, and get it back as an image. For example, a script that runs every Monday can send that week's sales figures and get back a chart for a report. A program proves it is yours with an API key, which is a password for programs. Create one on your [account page](https://chartjuice.com/account), under API keys.

The API is part of every plan, Free included, within [your plan's limits](https://chartjuice.com/docs/limits/).

- [API reference](https://chartjuice.com/docs/api/): Make your first chart in three requests, then look up any endpoint: its address, its fields and an example in curl, JavaScript and Python.
- [Chart edits](https://chartjuice.com/docs/ops/): Every edit you can make to a chart (an "op"), with its fields and an example.
- [Limits and errors](https://chartjuice.com/docs/limits/): What your plan allows, how fast you can send requests, and what each error code means.
- [Changelog](https://chartjuice.com/docs/changelog/): What has changed in the API, the connection for assistants and image links, with dates.

Every page of these docs can also be read as Markdown, which suits an AI assistant or a script better than a web page: put `.md` in place of the last slash of a page's address. `https://chartjuice.com/llms.txt` lists them all.

---

This is https://chartjuice.com/docs/ as Markdown. Every docs page is listed at https://chartjuice.com/llms.txt.