> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect your Notion AI agent to CoinGecko MCP to access live crypto data — prices, market caps, trending coins, onchain analytics, and more.

> **Prerequisites**
>
> * A Notion account with AI features enabled
> * A CoinGecko API key (required for authenticated access, Notion does not support non-authenticated MCP)

***

## Overview

Notion's AI Agents support custom MCP (Model Context Protocol) connections, allowing you to extend your agent with real-time external data. By connecting the CoinGecko MCP server, your Notion agent gains access to:

* **Real-time prices** for 15,000+ cryptocurrencies across 1,000+ exchanges
* **Onchain analytics** from GeckoTerminal — 8M+ tokens across 200+ networks
* **Market trends** — trending coins, top gainers/losers, new listings
* **Historical data** — OHLCV, price charts, and market history
* **Rich metadata** — project descriptions, contract addresses, social links, and more

***

## Which MCP Server Should You Use?

| Server                  | URL                                     | Auth            | Best For                                         |
| :---------------------- | :-------------------------------------- | :-------------- | :----------------------------------------------- |
| **Pro (Authenticated)** | `https://mcp.pro-api.coingecko.com/mcp` | OAuth (API Key) | Production agents, higher rate limits, 76+ tools |

*Note: Notion MCP does not support non-authenticated MCP*

***

## Step 1 — Create Your Notion AI Agent

<Frame>
  <img src="https://mintcdn.com/coingecko/WF4uvcVU5uC4fZ0I/images/notion-agent-coingecko-mcp-setup.png?fit=max&auto=format&n=WF4uvcVU5uC4fZ0I&q=85&s=f3289f3da00070070347babdbfd1a53f" alt="Notion Agent Coingecko Mcp Setup" width="1822" height="1128" data-path="images/notion-agent-coingecko-mcp-setup.png" />
</Frame>

1. Open Notion and navigate to **AI Agents** (or click **+ New agent** from the sidebar).
2. In the agent creation dialog, describe what your agent should do.
   > **Suggested prompt:** `CoinGecko API agent that has the knowledge of all cryptocurrencies`
3. Click the arrow to submit and continue to the agent configuration screen.

***

## Step 2 — Add the CoinGecko MCP Connection

<Frame>
  <img src="https://mintcdn.com/coingecko/WF4uvcVU5uC4fZ0I/images/notion-agent-coingecko-mcp-add-connection.jpg?fit=max&auto=format&n=WF4uvcVU5uC4fZ0I&q=85&s=c02d41c20c96133e3d30c10d240c29a1" alt="Notion Agent Coingecko Mcp Add Connection" width="2310" height="1638" data-path="images/notion-agent-coingecko-mcp-add-connection.jpg" />
</Frame>

1. Inside your agent's settings, click **Add connection**.
2. In the connection panel that opens, scroll to the bottom of the left sidebar and click **+ Add custom MCP**.
   > The right panel will show a **Custom MCP server** form with an empty URL field.

***

## Step 3 — Configure the MCP Server

Requires a CoinGecko API key. Get your key at [coingecko.com/en/api/pricing](https://www.coingecko.com/en/api/pricing).\\

<Frame>
  <img src="https://mintcdn.com/coingecko/WF4uvcVU5uC4fZ0I/images/notion-agent-coingecko-mcp-connection-form.png?fit=max&auto=format&n=WF4uvcVU5uC4fZ0I&q=85&s=67cbbfa598189119f8c0df97c24924d7" alt="Notion Agent Coingecko Mcp Connection Form" width="1376" height="1220" data-path="images/notion-agent-coingecko-mcp-connection-form.png" />
</Frame>

| Field              | Value                                   |
| :----------------- | :-------------------------------------- |
| **MCP server URL** | `https://mcp.pro-api.coingecko.com/mcp` |
| **Name**           | `CoinGecko MCP`                         |
| **Authentication** | OAuth                                   |

> Notion will display a warning: *"Notion hasn't reviewed this server."* This is expected for all custom MCP servers — the CoinGecko MCP is safe to connect.

Click **Connect**.

***

## Step 4 — Authorize with Your CoinGecko API Key (Pro Only)

After clicking Connect on the Pro server, a browser tab will open at `mcp.pro-api.coingecko.com/authorize`.

1. Paste your **Pro API Key** into the field.
2. Click **Log in and Approve**.

Your Notion agent is now authorized to access CoinGecko data via the MCP server.

> **Don't have a Pro key yet?** You can also use a Demo key. See the [API Key Differences](https://claude.ai/new?incognito=#api-key-differences) section below.

***

## Step 5 — Start Using Your Agent

Your Notion AI agent is now connected to live CoinGecko data. Try these example prompts:

### Simple Queries

* *What is the current price of Bitcoin in USD?*
* *What is the market cap of Ethereum?*
* *What are the top 3 trending coins on CoinGecko right now?*

### Advanced Queries

* *Show me the top 10 cryptocurrencies by market cap with price, 24h change, and volume in a table.*
* *Generate a 30-day price chart for Solana against USD.*
* *What are the top AI-related coins on GeckoTerminal right now?*

### Notion-Specific Workflows

* *Research the top 5 DeFi coins and save a summary to this page.*
* *Pull today's trending coins and add them as a database entry.*
* *Compare Bitcoin and Ethereum's performance this week and draft a report.*

***

## Troubleshooting

**The Connect button stays greyed out** Make sure the MCP server URL begins with `https://` and is a complete, valid URL.

**"Notion hasn't reviewed this server" warning** This appears for all custom MCP connections and is not an error. It is safe to proceed with the CoinGecko MCP.

**Authorization page doesn't open** Check that your browser isn't blocking popups from Notion. Allow popups and retry.

**Agent returns no crypto data** Confirm the MCP connection is active in your agent's connection settings. If using the Pro server, re-authorize if your session has expired.