> ## 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 for live crypto data

[Notion](https://www.notion.com) AI Agents support custom MCP connections, giving your agent access to live CoinGecko data — prices, market trends, onchain analytics, and more.

<Note>
  Notion requires authenticated MCP — [CoinGecko API key](https://www.coingecko.com/en/api/pricing) is needed.
</Note>

## Setup

<Steps>
  <Step title="Create an AI agent">
    Open Notion and navigate to **AI Agents** (or click **+ New agent** from the sidebar). Describe what your agent should do.

    <Frame>
      <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/notion-create-agent.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=895dd05f52495b47c24b270d9e6414ef" width="1778" height="1074" data-path="assets/images/notion-create-agent.png" />
    </Frame>
  </Step>

  <Step title="Add MCP connection">
    In your agent's settings, click **Add connection**. Scroll to the bottom of the left sidebar and click **+ Add custom MCP**.

    <Frame>
      <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/notion-add-connection.jpg?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=9019711a74cc6db93fca4eb17b043d32" width="2250" height="1610" data-path="assets/images/notion-add-connection.jpg" />
    </Frame>
  </Step>

  <Step title="Configure the MCP server">
    Fill in the connection form:

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

    <Frame>
      <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/notion-connection-form.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=c4de3c211a4f3814078226d17e208d44" width="1334" height="1186" data-path="assets/images/notion-connection-form.png" />
    </Frame>

    > Notion displays a warning: *"Notion hasn't reviewed this server."* This is expected for all custom MCP servers.

    Click **Connect**.
  </Step>

  <Step title="Authorize with your API key">
    A browser tab opens at `mcp.pro-api.coingecko.com/authorize`. Paste your API key and click **Log in and Approve**.

    > Get a key at [coingecko.com/en/api/pricing](https://www.coingecko.com/en/api/pricing).
  </Step>
</Steps>

## Try It Out

Your Notion AI agent now has access to live CoinGecko data. Try these prompts:

* *"What is the current price of Bitcoin in USD?"*
* *"Show me the top 10 cryptocurrencies by market cap with price, 24h change, and volume in a table."*
* *"What are the top trending coins on CoinGecko right now?"*
* *"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."*

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connect button stays greyed out">
    Make sure the MCP server URL begins with `https://` and is a complete, valid URL.
  </Accordion>

  <Accordion title="'Notion hasn't reviewed this server' warning">
    This appears for all custom MCP connections and is not an error. Safe to proceed.
  </Accordion>

  <Accordion title="Authorization page doesn't open">
    Check that your browser isn't blocking popups from Notion. Allow popups and retry.
  </Accordion>

  <Accordion title="Agent returns no crypto data">
    Confirm the MCP connection is active in your agent's settings. Re-authorize if your session has expired.
  </Accordion>
</AccordionGroup>