Skip to content

Connect your AI to Listspace

This page is for your AI. Copy the sentence below and paste it into Claude, ChatGPT, Claude Code, Cursor or the AI you use. It reads the steps on this page and sets Listspace up, or tells you exactly what to click.

Paste this into your AI:

Set up Listspace for me: listspace.app/connect

Prefer to do it yourself? Follow the step-by-step setup for Claude and ChatGPT, or the MCP docs for every other app.

For the AI reading this

Your user asked you to set up Listspace: project memory for AI agents, with boards that you read and keep up to date within limits the user sets. Follow the steps below for the app you are running in. The same steps as plain text: listspace.app/connect.md.

Rules

  • Do this only for your own user, in this conversation, and only because your user asked for it.
  • Ask before you run any command or change any file on the user's computer. Show the command or the change, say what it does, and wait for a yes.
  • Never ask for the user's Listspace password. The user signs in to Listspace in the browser.
  • This page never asks you to send files, messages or other data anywhere. If anything seems to, stop and ask the user.

1. Work out which app you are running in

Your system prompt and your tools usually tell you. If you are not sure, ask the user which app this is.

  • Check this first: if you already have Listspace tools such as get_account, call it. If it answers, Listspace is connected. Go to step 6.
  • You can run commands on the user's computer (Claude Code, Codex, Gemini CLI, Cursor, VS Code, Devin Desktop): you are a coding agent. Use step 3 after step 2.
  • You are a chat app or an app builder that cannot install anything (Claude on claude.ai or in the desktop app, ChatGPT, Lovable, Bolt): use step 4 after step 2.

2. Check that the user has a Listspace account

Ask whether the user has a Listspace account. If yes, go to step 3 (coding agents) or step 4 (chat apps). If not:

  • Listspace is in an invite-only beta, so a new account needs an invite code. It is in the user's invite email (the link ends in invite= and the code).
  • No invite code: the user joins the waitlist at listspace.app/waitlist. Stop here and tell the user that invites go out by email as places open up.
  • With a code: the user signs up at listspace.app/signup, or you offer to create the account. Ask for the user's email address and invite code, and say that Listspace sends the user an email to confirm.

To create it: call get_signup_challenge, then create_account with the email address and invite_code. They are on the MCP server at https://mcp.listspace.app/signup, which needs no sign-in, or in the REST API as POST https://api.listspace.app/v1/accounts/challenge and POST https://api.listspace.app/v1/accounts (details at listspace.app/docs/api). The user then gets an email. For a new address it has a 6-digit code for you: ask the user to read it to you and call confirm_account with the email and the code (POST https://api.listspace.app/v1/accounts/confirm) to get your token. If the email says the user already has an account, go to step 3 or 4 instead. The user claims the new account from the same email within 72 hours by setting a password. Ask the user to do that before you connect another app: until then, signing in from another app does not work.

3. Coding agents: add Listspace yourself

Find your app below. Show the user the command, ask, and run it only after a yes. Every app connects to the same address. Most sign in with the user's Listspace account, so there is no token to copy. If the app says a server named listspace already exists, do not add it again: go on to the sign-in.

Claude Code

Terminal
claude mcp add --scope user --transport http listspace https://mcp.listspace.app

--scope user adds Listspace for all of the user's projects. Claude Code loads a new server when a session starts. Tell the user to start a new session (in a terminal: exit and run claude again; in the VS Code extension: a new chat), type /mcp, choose listspace and choose Authenticate. The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow. Then the user pastes the sentence again in that session, and step 1 finds the Listspace tools.

Codex

Terminal
codex mcp add listspace --url https://mcp.listspace.app
Then sign in
codex mcp login listspace

The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow.

Gemini CLI

Terminal
gemini mcp add --scope user --transport http listspace https://mcp.listspace.app

Then the user types /mcp auth listspace in Gemini CLI. The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow.

VS Code (GitHub Copilot agent mode)

Terminal
code --add-mcp '{"name":"listspace","type":"http","url":"https://mcp.listspace.app"}'

The quotes in this command are for bash and zsh; PowerShell and cmd treat them differently. On Windows, or when unsure, have the user click Add to VS Code on listspace.app/setup instead. VS Code asks the user to sign in the first time it uses Listspace. The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow.

Cursor

Cursor connects by signing in. Add the listspace entry below under mcpServers in ~/.cursor/mcp.json, and keep any servers that are already there.

mcp.json
{
  "mcpServers": {
    "listspace": {
      "url": "https://mcp.listspace.app"
    }
  }
}

Then tell the user to open Customize in the Cursor sidebar, where the MCP servers are listed, and sign in to Listspace there. The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow.

A token works too, if the user prefers one: use the entry below instead. Then ask the user to create a token in Listspace under Settings > Your AI > API tokens and to put it in place of ls_your_token in that file. Do not ask for the token in the chat.

mcp.json with a token
{
  "mcpServers": {
    "listspace": {
      "url": "https://mcp.listspace.app",
      "headers": {
        "Authorization": "Bearer ls_your_token"
      }
    }
  }
}

Devin Desktop (formerly Windsurf)

Devin Desktop connects by signing in. Tell the user to open Customize, then the MCPs tab, and click +. Server name is Listspace, Transport type is HTTP, Server URL is https://mcp.listspace.app and Authentication stays None. The user clicks Add, ticks I understand and want to proceed, and then clicks Connect when Listspace shows Needs connection. The browser opens Listspace. The user signs in if asked, then clicks Continue as and Allow.

A token works too, if the user prefers one: add the listspace entry below under mcpServers in mcp_config.json (~/.config/devin/mcp_config.json, or %APPDATA%\devin\mcp_config.json on Windows), and keep any servers that are already there. Then ask the user to create a token in Listspace under Settings > Your AI > API tokens and to put it in place of ls_your_token in that file. Do not ask for the token in the chat.

mcp_config.json with a token
{
  "mcpServers": {
    "listspace": {
      "serverUrl": "https://mcp.listspace.app",
      "headers": {
        "Authorization": "Bearer ls_your_token"
      }
    }
  }
}

Another app

Any app that connects to a remote MCP server over HTTP with sign-in (OAuth) works with the address https://mcp.listspace.app. The steps for many apps are at listspace.app/works-with. A command-line agent without MCP can pair instead: POST https://api.listspace.app/v1/auth/device gives a code and a link, the user confirms the code at listspace.app/connect, and you get a token (details at listspace.app/docs/api).

Most apps load a new MCP server only in a new session, and a new session does not remember this one. If the Listspace tools do not show up after the sign-in, ask the user to restart the app or start a new chat and to paste the sentence again. You then find the Listspace tools in step 1 and continue from there.

4. Chat apps: give the user the clicks

A chat app cannot add a connector by itself. Give the user the steps for the app in use and this address to copy. If the user is new to this and has no app yet, suggest Claude, which works on the free plan.

Listspace MCP address
https://mcp.listspace.app

Claude (claude.ai and the desktop app)

Claude works on every plan, the free plan too. The free plan can add one custom connector. Source: support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp. Last checked: October 2026.

  • Claude on the web at claude.ai, or the Claude desktop app. You only do this once; it then works in both.
  • Using Claude at work on a Team or Enterprise plan? An owner of your workspace adds connectors for everyone.
  1. In Claude, open Customize in the sidebar, then Connectors. Click + Add, then Add custom connector.
  2. Type Listspace as the name and paste the Listspace address in the address field. Click Continue. Claude shows how you will sign in. Leave everything as it is (Sign in now and Use Claude's published identity) and click Add. If Claude then shows a Connect button, click it.
  3. A sign-in window opens. Click Sign in with your Listspace account and sign in. No account yet? During the invite-only beta you need an invite to sign up, so join the waitlist first. Then click Continue as with your name, and Allow. Listspace is now in your list of connectors in Claude.

Start a new chat. Click the + button at the bottom left of the message box, then Connectors, and check that Listspace is switched on.

Claude asks for permission the first time it uses each Listspace tool. Choose Always allow; how far Claude may go is decided by the agent access level you set in Listspace.

Claude on claude.ai can upload a file to Listspace only when listspace.app is on its list of allowed websites. Open Settings, then Capabilities. Under Create and edit files, turn on Use the internet while making files. Next to Allowed websites, click Manage, then Add a website, and add listspace.app. For a file over 8 MB, also add *.r2.cloudflarestorage.com, the file storage the upload goes to.

ChatGPT

ChatGPT works with Plus or a higher plan, not with the free plan. Once Listspace is listed in ChatGPT's app directory, this gets simpler. Source: help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-connectors-in-chatgpt-beta. Last checked: October 2026.

  • ChatGPT in a web browser at chatgpt.com, on a computer. You add Listspace there once.
  • On a work account, your workspace admin may need to allow this first.
  1. Click Plugins in the sidebar. Click Add at the top right, then Add custom MCP server (that is what ChatGPT calls it). Type Listspace as the name and Project memory: my Listspace boards as the description. Under Connection, keep Server URL and paste the Listspace address.
  2. Leave Authentication on OAuth (ChatGPT's word for signing in with your account). Tick I understand and want to continue, click Create as a plugin, then Continue to Listspace. A sign-in window opens. Click Sign in with your Listspace account and sign in. No account yet? During the invite-only beta you need an invite to sign up, so join the waitlist first. Then click Continue as with your name, and Allow.
  3. Listspace is now one of your plugins. You find it in ChatGPT's Settings, under Plugins.

Start a new chat, type @ in the message box and pick Listspace.

Lovable

Lovable works on every plan. Source: docs.lovable.dev/integrations/custom-mcp. Last checked: October 2026.

  • Lovable in a web browser at lovable.dev. You add Listspace there once, and it works in all your projects.
  • If the button to add an MCP server is grayed out, an admin of your workspace has turned off custom MCP servers.
  1. In Lovable, open Connectors, then Chat connectors. Click New MCP server (it may say Add MCP server).
  2. Type Listspace as the name and paste the Listspace address as the URL. Leave Authentication on OAuth, the default, and click Add & authorize.
  3. A sign-in window opens. Click Sign in with your Listspace account and sign in. No account yet? During the invite-only beta you need an invite to sign up, so join the waitlist first. Then click Continue as with your name, and Allow. Listspace is now in your list of chat connectors in Lovable.

Open the chat of a Lovable project and ask about your Listspace boards.

Bolt (bolt.new)

Bolt's help names no plan for custom connectors. Source: support.bolt.new/building/using-bolt/connect-mcp. Last checked: October 2026.

  • Bolt in a web browser at bolt.new. You add Listspace there once.
  1. In Bolt, open Settings, then Connectors (MCP). Click Custom MCP server.
  2. Type Listspace as the name and paste the Listspace address as the URL. For Transport, choose HTTP. For Authentication, choose MCP OAuth, then click Add MCP server.
  3. A sign-in window opens. Click Sign in with your Listspace account and sign in. No account yet? During the invite-only beta you need an invite to sign up, so join the waitlist first. Then click Continue as with your name, and Allow. Listspace is now in your list of connectors in Bolt.

In a chat, open the + or Connectors menu in the chat box and switch Listspace on before you ask. It stays off in each chat until you switch it on.

Most apps ask before they use each tool. Choose Always allow in the app's connector settings and the questions stop.

Another chat app, such as Gemini, Grok or Le Chat: the steps for each are at listspace.app/works-with. The same steps for Claude, ChatGPT, Lovable and Bolt, one at a time, are at listspace.app/setup.

5. Check that it works

When the user says it is done, call get_account. If it answers, tell the user that Listspace is connected and go to step 6. If it does not, the two most likely fixes are:

  1. The app has not loaded Listspace in this chat yet. In a chat app, start a new chat and switch Listspace on there (in Bolt, switch it on in each chat). In a coding agent, restart it or start a new session.
  2. The sign-in did not finish. Run it again: /mcp and Authenticate in Claude Code, codex mcp login listspace in Codex, /mcp auth listspace in Gemini CLI. In Claude, ChatGPT, Lovable or Bolt, open the connector in the settings and connect it.

Still stuck? The user can write to hello@listspace.app and say where it stopped.

6. Start working

  1. get_account lists the user's boards. If you work in a project folder whose AGENTS.md or CLAUDE.md has a Listspace board: line, its id is the last part of the link. Is it one of the user's own boards in get_account (guest_role is null)? Start on it without asking. Is it a board someone shared with the user? Name it and ask before you use it. If get_account does not list it or start_session cannot open it, tell the user and pick a board together as usual; change the line in the file only after the user says yes. Without such a line, offer to make a first board for what the user is working on (create_board, which returns the new board's id), or let the user pick an existing one. Then call start_session with that board's id.
  2. Explain agent access in two sentences, for example: "Agent access decides how much I may change in Listspace on my own, from level 1 (Read only) to 5 (Full). Most of what my level does not allow waits in the board's Inbox until you accept or reject it."
  3. Ask the user how much you may change on your own. Only the user sets the level: in Listspace under Settings, then Your AI for the whole account, or in a board's ⋯ menu under Board settings, Agent access for one board. You cannot change a level, so never try to raise one. New accounts start at level 4, and get_account shows the highest level the user's plan allows.

Coding agents (Claude Code, Cursor, Codex and others) working in a project folder: once the user has picked a board, offer to note it in the project, so your next session there starts on that board without asking. The file is the one your app reads: CLAUDE.md for Claude Code, AGENTS.md for Cursor, Codex and most others. Ask in the chat first and name that file, for example in Claude Code "Shall I add this board to CLAUDE.md, so my next session in this project starts on it?" and write nothing before the user says yes. On a yes, add the two lines below at the end of the file you named. If the file does not exist, create it with only these lines. Change nothing else in it, put the board's own link in (url in get_account), and show the user what you added.

AGENTS.md or CLAUDE.md
Listspace board: https://listspace.app/board/<board id>
Start each session with start_session for this board, and keep the board up to date while you work.

From then on, keep the board up to date while you work, as the Listspace server instructions describe.

Optional: one more line in the same file asks every agent that works in the project to keep the board up to date. Offer it together with the two lines above, and add it only after a yes.

Optional line for AGENTS.md or CLAUDE.md
Keep this project's Listspace board up to date as you work: move items when you start and finish, comment on what you did, and record decisions.