Spiral gives your agent every tool with one account. Browse the tools →

Notion · LLMReleased 2025-08-07

How to Use GPT-5 in Notion

GPT-5 suits debugging, code edits, and tasks where you want to adjust reasoning effort. Its maximum output budget is 128,000 tokens, compared with GPT-5 Pro's 272,000.

Prompts to try with GPT-5 in Notion

Copy an example into Notion, or ask in your own words.

Each morning, use GPT-5 to turn the supplied engineering updates into a 300-word brief. Separate completed work, reported blockers, and unanswered questions; preserve all stated dates.

GPT-5Notion
Try asking
  • After each planning cycle, use GPT-5 to edit the supplied decision notes into a memo. Preserve the recommendation and evidence, remove repetition, and flag unsupported claims.

  • Every Monday, use GPT-5 to draft an engineering status report from the supplied updates. Use the same sections each time: completed work, next steps, risks, and questions.

  • Every Monday at 9am: ask GPT-5 through Spiral to review the diff on this branch and list the three riskiest changes.

  • Get a second opinion from GPT-5 on this function, then tell me what the call cost.

How to set up GPT-5 in Notion

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send Notion this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use Spiral's MCP server

  1. Allow custom MCP servers

    A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

  2. Add Spiral to a custom agent

    Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

    https://api.spiral.ai/mcp
  3. Sign in to Spiral and approve

    Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

  4. Run GPT-5 in a workflow step

    Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds GPT-5, prices it and runs it each time the step fires.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run GPT-5

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "openai",
        "model": "openai/gpt-5",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Notion finds GPT-5 on Spiral, shows the price and runs it.

GPT-5 providers and prices

Spiral runs GPT-5 through OpenAI. Open a card for today's price, with every fee included.

OpenAIDeprecatedLLM
GPT-5
openai/gpt-5

Settings you can ask for

Ask Notion for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Max tokens16 to 128000

The most output tokens to generate.

Reasoning effortminimal, low, medium, or high

How much the model reasons.

Parallel tool callson or off

Every API field of GPT-5 is on its tool page: open its card above.

What can you do with GPT-5 in Notion?

Turn incoming technical updates into consistent briefs and draft reports. Give GPT-5 a fixed review rubric and require it to distinguish supplied evidence from interpretation.

Debug a failing workflow

Provide the relevant code, error messages, and expected behavior. Ask for a likely cause, a focused correction, and a test that would catch the failure.

Plan a code refactor

Ask for a refactor that preserves public behavior, identifies affected callers, and explains which checks should pass before accepting the change.

Explain an unfamiliar codebase

Supply relevant modules and ask how a request moves through them. Request references to the functions that handle validation, state changes, and errors.

Review a mathematical argument

Provide a proposed solution and ask for unsupported steps, missing assumptions, and a concise corrected argument.

Draft a technical report

Turn supplied findings into a report for a defined audience. Require separate sections for observations, interpretation, and unresolved questions.

Edit a decision memo

Ask for a clearer recommendation, explicit tradeoffs, and a list of claims that need supporting evidence. Set a word limit and preserve the supplied facts.

Explain a scientific result

Provide the result, method, and stated assumptions. Ask for an explanation of the argument and questions that would help assess the conclusion.

Questions about GPT-5 in Notion

Can Notion use GPT-5?

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run GPT-5 like any built-in tool.

How much does GPT-5 cost in Notion?

Up to $0.053306 per run at the default inputs. $1.625 per 1M input tokens, $0.1625 per 1M cached input tokens, $13.00 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

Do I need an OpenAI account to use GPT-5 in Notion?

No. Spiral runs GPT-5 on its own OpenAI account. You sign in to Spiral once and never paste a key.

How long does it take to set up GPT-5 in Notion?

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

Does Notion wait while GPT-5 runs?

GPT-5 runs in the background. Notion starts the run, checks on it and gives you the text, json when it's ready.

What is GPT-5 useful for?

GPT-5 is useful for debugging, editing code, and explaining complex codebases. Practical writing tasks include drafting and editing reports, emails, and memos.

How much context can GPT-5 handle?

GPT-5 and GPT-5 Pro each have a 400,000-token context window. Treat that as a total context limit, rather than a promise that you can submit that much source text and still receive a full-length answer.

Does GPT-5 know about recent events?

GPT-5 and GPT-5 Pro have a September 30, 2024 knowledge cutoff. Supply dated source material when your question depends on newer events or changes.

Can I ask GPT-5 for a short answer?

Yes. Specify the length and structure directly, such as a 150-word explanation or a table followed by three recommendations.

How should I prompt GPT-5?

State the task, relevant evidence, constraints, and desired output clearly. Check that your instructions agree, especially when combining standing rules with a new request.

Get started

Start using GPT-5 in Notion

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Notion:

Set up Notion

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options