# Notion Slim

> notion MCP (52% less tokens). Quick setup: npx notion-slim --setup

- **Type:** MCP server
- **Install:** `agentstack add mcp-mcpslim-notion-slim`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mcpslim](https://agentstack.voostack.com/s/mcpslim)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mcpslim](https://github.com/mcpslim)
- **Source:** https://github.com/mcpslim/notion-slim
- **Website:** https://mcpslim.github.io/notion-slim

## Install

```sh
agentstack add mcp-mcpslim-notion-slim
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# notion-slim

> **Notion MCP server optimized for AI assistants** — Reduce context window tokens by 73.0% while keeping full functionality. Compatible with Claude, ChatGPT, Gemini, Cursor, and all MCP clients.

[](https://www.npmjs.com/package/notion-slim)
[](https://github.com/mcpslim/mcpslim)
[](https://modelcontextprotocol.io)

## What is notion-slim?

A **token-optimized** version of the Notion [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server.

### The Problem

MCP tool schemas consume significant **context window tokens**. When AI assistants like Claude or ChatGPT load MCP tools, each tool definition takes up valuable context space.

The original `@notionhq/notion-mcp-server` loads **21 tools** consuming approximately **~26,073 tokens** — that's space you could use for actual conversation.

### The Solution

`notion-slim` intelligently **groups 21 tools into 10 semantic operations**, reducing token usage by **73.0%** — with **zero functionality loss**.

Your AI assistant sees fewer, smarter tools. Every original capability remains available.

## Performance

| Metric | Original | Slim | Reduction |
|--------|----------|------|-----------|
| Tools | 21 | 10 | **-52%** |
| Schema Tokens | 14,103 | 1,352 | **90.4%** |
| Claude Code (est.) | ~26,073 | ~7,052 | **~73.0%** |

> **Benchmark Info**
> - Original: `@notionhq/notion-mcp-server@2.0.0`
> - Schema tokens measured with [tiktoken](https://github.com/openai/tiktoken) (cl100k_base)
> - Claude Code estimate includes ~570 tokens/tool overhead

## Quick Start

### One-Command Setup (Recommended)

```bash
# Claude Desktop - auto-configure
npx notion-slim --setup claude

# Cursor - auto-configure
npx notion-slim --setup cursor

# Interactive mode (choose your client)
npx notion-slim --setup
```

Done! Restart your app to use notion.

> ⚠️ **This MCP requires environment variables.** The setup will add placeholders - update them with your actual values. See [Configuration](#configuration).

### CLI Tools (already have CLI?)

```bash
# Claude Code (creates .mcp.json in project root)
claude mcp add notion -s project --env NOTION_API_KEY= -- npx -y notion-slim@latest

# Windows: use cmd /c wrapper
claude mcp add notion -s project --env NOTION_API_KEY= -- cmd /c npx -y notion-slim@latest

# VS Code (Copilot, Cline, Roo Code)
code --add-mcp '{"name":"notion","command":"npx","args":["-y","notion-slim@latest"],"env":{"NOTION_API_KEY":""}}'
```

## Configuration

### Required Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `NOTION_API_KEY` | Notion Integration Token (from notion.so/my-integrations) | Yes |

## Manual Setup

Click to expand manual configuration options

### Claude Desktop

Add to your `claude_desktop_config.json`:

| OS | Path |
|----|------|
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-slim@latest"],
      "env": {
        "NOTION_API_KEY": ""
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json` (global) or `/.cursor/mcp.json` (project):

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-slim@latest"],
      "env": {
        "NOTION_API_KEY": ""
      }
    }
  }
}
```

## How It Works

MCPSlim acts as a **transparent bridge** between AI models and the original MCP server:

```
┌─────────────────────────────────────────────────────────────────┐
│  Without MCPSlim                                                │
│                                                                 │
│  [AI Model] ──── reads 21 tool schemas ────→ [Original MCP]    │
│             (~26,073 tokens loaded into context)                 │
├─────────────────────────────────────────────────────────────────┤
│  With MCPSlim                                                   │
│                                                                 │
│  [AI Model] ───→ [MCPSlim Bridge] ───→ [Original MCP]           │
│       │                │                      │                 │
│   Sees 10 grouped      Translates to        Executes actual   │
│   tools only         original call       tool & returns    │
│   (~7,052 tokens)                                              │
└─────────────────────────────────────────────────────────────────┘
```

### How Translation Works

1. **AI reads slim schema** — Only 10 grouped tools instead of 21
2. **AI calls grouped tool** — e.g., `interaction({ action: "click", ... })`
3. **MCPSlim translates** — Converts to original: `browser_click({ ... })`
4. **Original MCP executes** — Real server processes the request
5. **Response returned** — Result passes back unchanged

**Zero functionality loss. 73.0% token savings.**

## Available Tool Groups

| Group | Actions |
|-------|---------|
| `get` | 4 |
| `post` | 2 |
| `patch` | 2 |
| `retrieve` | 5 |
| `update` | 2 |
| `create` | 2 |

Plus **4 passthrough tools** — tools that don't group well are kept as-is with optimized descriptions.

## Compatibility

- ✅ **Full functionality** — All original `@notionhq/notion-mcp-server` features preserved
- ✅ **All AI assistants** — Works with Claude, ChatGPT, Gemini, Copilot, and any MCP client
- ✅ **Drop-in replacement** — Same capabilities, just use grouped action names
- ✅ **Tested** — Schema compatibility verified via automated tests

## FAQ

### Does this reduce functionality?

**No.** Every original tool is accessible. Tools are grouped semantically (e.g., `click`, `hover`, `drag` → `interaction`), but all actions remain available via the `action` parameter.

### Why do AI assistants need token optimization?

AI models have limited context windows. MCP tool schemas consume tokens that could be used for conversation, code, or documents. Reducing tool schema size means more room for actual work.

### Is this officially supported?

MCPSlim is a community project. It wraps official MCP servers transparently — the original server does all the real work.

## License

MIT

---

  Powered by MCPSlim — MCP Token Optimizer
  
  Reduce AI context usage. Keep full functionality.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mcpslim](https://github.com/mcpslim)
- **Source:** [mcpslim/notion-slim](https://github.com/mcpslim/notion-slim)
- **License:** MIT
- **Homepage:** https://mcpslim.github.io/notion-slim

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-mcpslim-notion-slim
- Seller: https://agentstack.voostack.com/s/mcpslim
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.