Quick Start

Getting Started
with Octopad.

A short read to show you how Octopad works, from setup to your first goal. The full walkthrough lives inside the product once you sign up.

Shortcut worth knowing: once your AI is connected, you can ask it anything in this guide. "What is a work stream?" "How does the tracker page work?" Your AI already knows. This page is the printed backup. Your AI is the live tutor.

1. What Octopad is in 60 seconds

Octopad is your AI's back-office. Your strategy, tasks, plans, decisions, and team know-how live in one place your AI can read, write, and work from.

You work mostly by talking to your AI. It creates tasks, captures decisions, writes pages, and ties work to strategy. The Octopad interface is a control panel where you watch what your AI does and steer when needed. You can click around and build by hand, but the AI is faster and the output is richer.

Why this matters. A normal AI chat has no back-office. Every new conversation starts cold. Octopad gives every session the context your team has already captured, and a place to capture what comes next. Nothing gets re-explained. Nothing gets lost.

2. Set up in minutes

Here is what happens, step by step.

Sign up. Free, no credit card. Head to octopad.app.

Connect your AI. First step of onboarding. Pick the AI you actually use (ChatGPT, Claude, Gemini, Cursor, whichever) and follow the prompts to wire it up. This is what lets your AI read and write your workspace. Quick reference for the two most common:

MCP URL: https://mcp.octopad.app/mcp

Claude Code (CLI)

Claude Code is the command-line version of Claude that runs in your terminal. Follow these steps:

  1. Open your terminal (on Mac: Cmd + Space, type Terminal, hit Enter).
  2. Run this command: claude mcp add octopad --transport http https://mcp.octopad.app/mcp. You should see a confirmation that the server was added.
  3. Close and reopen Claude Code so it picks up the new connection.
  4. Inside the Claude Code session, type /mcp and hit Enter. You'll see octopad listed. Select it, then choose Authenticate.
  5. A browser window opens. Sign in with the same account you used to create your Octopad account (Google SSO, or your email and password). The window closes itself once you're signed in.
  6. Back in the terminal, run /mcp again. Octopad should now show as connected.
Claude Desktop / claude.ai

Works the same way in the Claude desktop app and at claude.ai. Follow these steps:

  1. Click the menu in the bottom-left of the interface, then Settings.
  2. Go to Connectors.
  3. Scroll to the bottom and click Custom connectors.
  4. Give it a name — Octopad — and paste the URL https://mcp.octopad.app/mcp.
  5. Octopad will appear in your list of connectors. Click Connect and sign in with the same account you used to create your Octopad account (Google SSO, or your email and password).
Cursor

Cursor is an AI-powered code editor. It connects through a small JSON config — two ways to add it:

Through Cursor's UI

  1. Open Cursor Settings — gear icon in the top-right, or Cmd + , / Ctrl + ,.
  2. In the sidebar, click Tools & MCPs.
  3. Under Installed MCP Servers, click New MCP Server. Cursor opens mcp.json.
  4. Paste the JSON below inside mcpServers and save.

Or edit the file directly

Drop the JSON below into ~/.cursor/mcp.json (macOS / Linux) or %USERPROFILE%\.cursor\mcp.json (Windows) for a global install, or .cursor/mcp.json at the root of your repo for per-project.

{
  "mcpServers": {
    "octopad": {
      "url": "https://mcp.octopad.app/mcp"
    }
  }
}

Once added, Octopad will show as Needs authentication — click the Connect button next to it to authorize. Or just ask Cursor to use Octopad in a chat and it will prompt you.

ChatGPT

ChatGPT runs Octopad as a custom app, which requires Developer mode. The web app at chatgpt.com and the Windows native app both let you enable Developer mode and add custom apps.

  1. Open Settings → Apps → Advanced settings and toggle Developer mode on.
  2. Back in Settings → Apps, click Create app.
  3. Fill the fields:
    • Name: Octopad
    • MCP server URL: https://mcp.octopad.app/mcp
    • Authentication: OAuth
  4. Click Connect. A browser tab opens — sign in with the same account you used to create your Octopad account (Google SSO, or your email and password).
  5. Optional, recommended: in ChatGPT, open the settings for the Octopad app you just created and enable "Reference memories and chats". It lets ChatGPT pull in your saved memory while working with Octopad, which improves output.

Create your workspace. Second step of onboarding. Name it, pick a few defaults, and you're in.

Open a fresh chat with your AI and say "use octopad." Type it exactly. Your AI loads a briefing from your workspace (core pages, active goals and streams, a recap of recent sessions, the Octopad playbook) and shows up with context in hand. Say it at the start of every fresh chat. Skip it and the AI still tries, but quality drops because it's flying blind.

Tell your AI about your company and your product. In that same chat, share the basics: what you're building, who it's for, where you stand today, what comes next. Your AI turns it into pages, typically a Product Overview and a Company Overview.

Add those pages to your workspace context. Open each page in Octopad and add it to workspace context. From now on, every AI working in this workspace gets that information loaded automatically, every chat. Set it once.

Create your first goal. Something like "Launch our beta by June 30." Your AI sets up a work stream under it (for example, "Marketing Website") and you have a real workspace to work from. From here on out, you're working.

To go deeper, the Learn section inside octopad.app walks through the rest.

3. The three systems your AI leans on

Three systems hold your AI's context. Your AI handles them for you. Knowing what's under the hood helps you get more out of Octopad.

Pages. Long-form documents: Product Overview, Company Overview, Brand Guidelines, strategy notes, research, meeting notes. Anything your AI should be able to pull from later. Every page gets an auto-generated summary, so your AI can skim the index before opening a page in full.

Key Information. Short, atomic items. Four kinds: a fact ("we ship on Fridays"), a decision ("we chose Stripe over Paddle for native payouts"), an open question ("do we need SOC 2 before Q4?"), and a risk ("our top competitor just raised"). Your AI captures these as they come up and pulls the relevant ones back when it picks up a task later.

Build Context. The engine that assembles the right material for each job. When you ask your AI to work on a task, build context loads the task, its dependencies, its linked pages, related key information, and the tracker page for its work stream. Your AI shows up already briefed.

4. How work is organized

Three layers, stacked from biggest to smallest.

Goals. What you're trying to achieve and why. Quarterly or yearly. For example: "Launch our beta by June 30."

Work Streams. How you get there. A stream is a project or an area of work. Two flavors:

  • Ongoing streams never close. They cover permanent areas like "Customer Support" or "Content."
  • Time-bound streams have a target date and a finish line. They sit under a goal, for example "Marketing Website" under "Launch our beta by June 30."

Every stream gets an auto-generated tracker page. An octobot logs activity as work lands and compresses the day into a clean report overnight. Open the tracker any time to see exactly what moved this week. You never update it by hand.

Tasks. The unit of work. Each task has a Why (the problem), a What (the scope), and a How (the approach, when it's non-obvious). Your AI adds a "Done when" line so you know when it's really finished. Tasks carry priority and impact, can have subtasks, and can depend on other tasks with a one-line rationale, so the order is never mysterious.

Full example. Goal: "Launch our beta by June 30." Work stream: "Marketing Website." Tasks: "Write the homepage copy," "Set up email capture," "Record the demo video," "Publish the site." Dependencies wire the order: write the copy before recording the video, since the video echoes the copy. Your AI picks what to work on next. You can always override.

5. What to do next

Sign up at octopad.app, say "use octopad" in your next chat, and give your AI the basics about your company and a first goal. That's the entire opening move.

octopad.ai is the marketing site. octopad.app is where the product lives, and where the Learn section walks you through everything else once you're in.

Start free See pricing