palewire/datawrapper-mcp

> **Status: early and experimental.** This project — including its Claude
> Code/Desktop plugin and marketplace listing — is under active development,
> and behavior can change between releases. In particular, the
> plugin/marketplace install path has known gaps (see
> issue #78) — don't
> treat it yet as a finished, zero-maintenance install path for a wider
> rollout.
Example Usage
You can provide a data file and simply ask for the chart you want. The draft will soon appear in the panel.
Here's a more complete example showing how to create, publish, update, and display a chart by chatting with the assistant:
Tools
| Tool | Description |
| ------------------ | -------------------------------------------------- |
| list_chart_types | List available chart types with descriptions |
| get_chart_schema | Get the full configuration schema for a chart type |
| create_chart | Create a new chart with data and configuration |
| update_chart | Update an existing chart's data or styling |
| publish_chart | Publish a chart to make it publicly accessible |
| get_chart | Retrieve a chart's configuration and metadata |
| delete_chart | Permanently delete a chart |
| export_chart_png | Export a chart as a PNG image |
Chart Types
bar, line, area, arrow, column, multiple column, scatter, stacked bar
Use list_chart_types to see descriptions, then get_chart_schema to explore configuration options for any type.
Getting Started
Requirements
- A Datawrapper account (sign up at https://datawrapper.de/signup/)
- An MCP client such as Claude or OpenAI Codex
- Python 3.10 or higher
Get Your API Token
1. Go to https://app.datawrapper.de/account/api-tokens
2. Create a new API token
3. Add it to your MCP configuration as shown in the installation guide
Quick Start (Claude Code)
For other clients (Claude Desktop, Claude.ai, Cursor, VS Code Copilot, ChatGPT, OpenAI Codex, OpenClaw) and Kubernetes deployment, see the installation guide.
> **Installing via a plugin marketplace/directory (Claude Desktop's plugin
> browser, ClawHub, etc.) is still experimental.** These interactive install
> flows currently have no working way to collect required environment
> variables like DATAWRAPPER_ACCESS_TOKEN — see
> issue #78 for
> details. The manually-edited config shown above (and throughout the
> installation guide) is the reliable path today.
Using Your Own Token (Hosted Deployments)
When connecting to a hosted instance of the server over HTTP, you can authenticate
with your own Datawrapper API token by sending it in the Authorization header:
This ensures charts are created under your account instead of the server operator's.
The token is read from the header automatically — no need to include it in every
tool call.
You can also pass access_token directly as a tool argument, which takes precedence
over the header. When neither is provided, the server falls back to its