# notion-arena [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/SynergyFlowLabs/notion-arena  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/notion-arena

## Description
MCP server for Notion Arena — 143 Notion components: 132 widgets + 11 recipes

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "notion-arena": {
    "command": "npx",
    "args": ["-y","notion-arena-mcp"]
  }
}
```

## Documentation

## What notion-arena MCP server does

The notion-arena MCP server connects an MCP client to Notion Arena, a machine-readable registry of reusable Notion components. The catalog contains two distinct types of assets:

- Widgets are self-contained HTML files designed for embedding in Notion through an iframe or uploading as an HTML block.
- Native recipes describe Notion workspace structures installed through the Notion API. They can include database schemas, views, formulas, and automations.

The project covers use cases such as dashboards, time tracking, planning, business workflows, documentation, visual layouts, and automations. Examples listed by the project include Pomodoro timers, KPI displays, habit grids, meeting-note templates, kanban boards, CRM pipelines, reading trackers, and org charts.

## How it works

The notion-arena MCP server makes the registry available to an MCP-compatible AI client so the client can work with the available widgets and recipes. A widget remains a presentation component: embedded versions require network access, while uploaded HTML blocks do not. Widget data is browser-local, and widgets do not provide team synchronization.

Recipes work differently. They are installed through the project’s `/api/install` endpoint using a Notion token, and the resulting data lives in the user’s Notion workspace. Recipe installations can therefore support shared workspace data, while updates require running the installation again. The README identifies the minimum plan for these assets as Free for widgets and Free, Plus, or Business for recipes.

## Setup and configuration

The repository provides an npm package named `notion-arena-mcp` and a deployment option through Vercel. The project also appears in the MCP Registry. For native recipes, setup requires a Notion token passed to the installation request. The provided material does not specify the token’s environment-variable name, a complete client configuration, or a required launch command.

Use the widget delivery method that matches the intended runtime. Choose an iframe when automatic updates and network access are acceptable; use an uploaded HTML block when the component should run without network access. Choose a native recipe when the result needs to live in Notion and synchronize with a team workspace.

## Tools and capabilities

The notion-arena MCP server is suited to component-oriented workflows, including:

- Exposing the Notion Arena component catalog to an MCP client.
- Working with reusable widgets for dashboards, trackers, planning, time, business, documentation, and visual content.
- Working with native recipes that define Notion databases, views, formulas, and automations.
- Supporting recipe installation through the Notion API and `/api/install`.
- Separating browser-local widget data from workspace-resident recipe data.

The README describes the catalog as containing 192 widgets and 11 recipes, while the supplied listing description states 143 total components. Treat the exact total as version-dependent or unresolved from the available material.

## Limitations and notes

Widgets and recipes have different operational constraints. Embedded widgets need network access, and widget data is local to the browser rather than synchronized across a team. Uploaded HTML widgets avoid runtime network access but require manual updates. Native recipes require a Notion token and an installation request, and changes are applied by reinstalling them.

Notion Arena is an independent project and is not affiliated with or endorsed by Notion Labs Inc. The repository is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/notion-arena/readme_