Skip to content

Getting Started

Set up a novem account, choose a client, and create your first plot.

1. Create an account

Novem currently requires an invitation. Ask an existing user for an invite, or contact the team through the novem community on Discord.

2. View novem on the web and your phone

Sign in at novem.io to view and manage your content. You can also view content in the novem iOS app.

3. Connect your agent to novem

To create content through an AI assistant, connect it to the novem MCP server at https://api.novem.io/mcp. Choose your client below. For command-line access, follow the CLI setup.

Run this once in your terminal:

Terminal
claude mcp add novem-mcp --transport http https://api.novem.io/mcp
Terminal · Bash1 line

Then run /mcp at the start of each session to activate the novem tools.

4. Create a plot

Give the assistant a dataset and specify the chart you want. For example, this prompt uses fictional data:

Create a private novem bar chart named example_counts, titled "Example counts". Use these fictional values: Group A = 10, Group B = 20, Group C = 15. Label the value axis "Count" and return the plot URL.

Open the returned URL while signed in to novem. Check that the chart has three bars with the supplied values. The plot quick start shows the equivalent workflow with CLI commands and API requests.

Set up the CLI

The novem CLI reads and writes resources through the API. Install it with pipx:

Terminal
pipx install novem
Terminal · Bash1 line

Then generate and store an API token:

Terminal
novem --init
Terminal · Bash1 line

Follow the prompts to authenticate. The CLI saves the token in ~/.config/novem/novem.conf.

Continue with a quick start for plots, documents, mails, repos and jobs — and the CLI guide covers configuration and day-to-day usage.

Next steps

  • Plot configuration covers titles, axes, colours, and legends.
  • Sharing explains how to grant access. New plots are private.
  • Jobs shows how to run code on a schedule.

Getting help

For setup questions or help with an example, contact the team through the novem community on Discord.

Next
Plots