MCP whiteboard
Use AIrboard from your AI agent.
AIrboard is an online whiteboard with a remote MCP server. Connect your agent once, then ask it to draw a diagram, sort sticky notes, or review a plan on the board your team already shares.
Get startedFree during early access. No credit card.
Works with Claude, ChatGPT, Cursor and more.
Connect your agent
The MCP server is https://api.airboard.build/mcp. It speaks Streamable HTTP and has tools only. Most clients log in with OAuth: you sign in to AIrboard in your browser, choose or create an agent, and approve it. In Claude Code, run this command, then type /mcp to log in:
claude mcp add --scope user --transport http airboard https://api.airboard.build/mcp
Pick your agent app for its steps:
Claude CodeTerminal
- Copy the command below and run it in your terminal.
- In Claude Code, type /mcp and select airboard to log in.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
claude mcp add --scope user --transport http airboard https://api.airboard.build/mcpClaudeWeb and desktop app
- In the Claude tab that opened, on Customize, then Connectors, add a custom connector named AIrboard with the URL below. The form may already hold both.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
https://api.airboard.build/mcpChatGPTWeb
- In the ChatGPT tab that opened, on Plugins, select +, then Add custom MCP server.
- Name it AIrboard. Paste the URL below into Server URL and choose OAuth for authentication.
- Review the warning, select I understand and want to continue, then Create as a plugin.
- Install AIrboard from your plugins.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- In a chat, type @ and select AIrboard. Ask: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
https://api.airboard.build/mcpCursorOne click
- Click Add to Cursor, or copy the configuration below into ~/.cursor/mcp.json. Use Cursor’s login action for airboard when prompted.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
{
"mcpServers": {
"airboard": {
"url": "https://api.airboard.build/mcp"
}
}
}VS CodeOne click
- Click Add to VS Code, or copy the command below and run it in your terminal.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
code --add-mcp '{"name":"airboard","type":"http","url":"https://api.airboard.build/mcp"}'CodexTerminal
- Copy the command below and run it in your terminal. It adds AIrboard and starts login.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
codex mcp add airboard --url https://api.airboard.build/mcp && codex mcp login airboardGemini CLITerminal
- Copy the command below and run it in your terminal. In Gemini CLI, use /mcp auth to log in to airboard.
- When asked, sign in to AIrboard with the same account you use here. Choose or create an agent, then approve access.
- Ask your agent: “Use AIrboard to list my boards.” Check that it lists the boards you can open here.
gemini mcp add --transport http --scope user airboard https://api.airboard.build/mcpAll other apps: Add a remote MCP server named airboard with this URL. Choose HTTP and OAuth if asked, then use your app’s login action.
https://api.airboard.build/mcp
Does your client have no OAuth? Make an agent on the Agents page after you log in, copy its token, and send it as Authorization: Bearer mym_…. A token opens the MCP server and nothing else. auth.md has the full flow for agent developers.
What your agent can do
Boards
List the boards of the agent's human, make a board, make a share link that is not public on a board the human owns, and leave a board.
list_boardscreate_boardcreate_share_linkleave_boardRead
An outline of the board, search, the items in a region or a frame, items by ID, a PNG render of part of the board, an image, and the changes since a board version. A call can wait up to 30 seconds for new changes.
board_outlinesearch_itemsread_regionread_frameget_itemsrender_regionview_imagechanges_sinceWrite
Create, change, and delete sticky notes, shapes, text, frames, and connectors. Connect items, group them, move them into frames, draw a Mermaid diagram as editable items, and undo the agent's own last change. Each call is one change, all or nothing.
create_itemsupdate_itemsdelete_itemsconnectgroup_itemsungroup_itemsmove_to_framecreate_mermaidundoFiles
Put an image or an HTML page on the board, from the call or through a single-use upload URL for a file on the agent's disk.
upload_imageupload_htmlstart_uploadComments
Read comment threads, add a comment or a reply, resolve and reopen a thread, and edit or delete the agent's own comments.
list_commentsget_threadadd_commentreplyresolvereopenedit_commentdelete_commentPresence and notes
Show a short status in the tag of the agent's cursor, and keep notes on the board for the next agent.
set_statusread_board_memorywrite_board_memory
The agent sees only the tools your access allows. With view access on every board, it gets no write or comment tools.
Requests to try
Map this repo's architecture on a new AIrboard board called Architecture. Draw the main parts and how they call each other.
The agent read the code, made the board, and drew two diagrams in frames: how a request moves through the system, and which part depends on which. Every box and arrow is an item you can edit.
Turn these meeting notes into a retro board called Sprint retro: one frame each for What went well, What was hard, and What to try next. Keep the wording of each note.
The agent made the board with three frames and one sticky note per point, in the words of the notes.
Read the Sprint retro board. On each sticky note in What was hard, add a comment with one question for the team.
The agent read the frame and added one comment with a question to each of its three sticky notes. It left the notes as they were.
Questions about agents
Which AI agents can connect?
Any MCP client that supports remote servers over HTTP: Claude, Claude Code, ChatGPT, Cursor, VS Code, Codex, Gemini CLI, and others. Clients that support OAuth log in with your AIrboard account. Other clients use an agent token from the Agents page.
Does my agent get more access than I have?
No. The agent acts for the person who connected it, with that person's access on each board. It cannot rename or delete boards, remove people, or revoke share links.
Can my team see what the agent does?
Yes. The agent is a participant on the board with its own cursor, selection, and status, and an Agent badge in the participant list. Its changes show at once in every open browser, and its undo takes back only its own changes.
How do I stop an agent?
Open the Agents page and select Revoke. That ends the agent's OAuth logins and its token at once.
Bring your agent to the board.
Make a board, invite your team, and connect your agent.
Get startedFree during early access. No credit card.
Works with Claude, ChatGPT, Cursor and more.