Skip to content

AI Assistants (MCP)

Boards Cloud includes an MCP (Model Context Protocol) server, so AI assistants like Claude can work with your boards on your behalf — find cards, create tasks, update assignments, summarise activity and more.

The MCP server is available at:

https://boards.api.huddo.com/mcp

Authentication uses OAuth: when your assistant first connects, you sign in with your normal Boards account and approve access. The assistant then acts as you — it can only see and change the boards you can.

Info

Running Boards Self-Hosted? Coming soon!

Claude Code

Add Boards to Claude Code from your terminal:

claude mcp add --transport http --client-id boards-mcp --scope user huddo-boards https://boards.api.huddo.com/mcp

Then start Claude Code and run /mcp to sign in to Boards. A browser window opens for the usual Boards login, and Claude Code is connected once you approve.

Tip

--scope user makes the connection available in all your projects. Omit it to add Boards to the current project only.

claude.ai and Claude Desktop

Add Boards as a custom connector:

  1. Open Settings → Connectors

  2. Click Add custom connector

  3. Enter a name (e.g. Huddo Boards) and the URL:

    https://boards.api.huddo.com/mcp

  4. Under Advanced settings, set the OAuth Client ID to boards-mcp (leave the client secret blank)

  5. Click Add, then Connect and sign in with your Boards account

Other MCP clients

Any MCP client that supports the streamable HTTP transport with OAuth can connect (e.g. LibreChat):

  • URL: https://boards.api.huddo.com/mcp
  • OAuth client ID: boards-mcp — a public client, so there is no client secret (PKCE is required)
  • Dynamic client registration is not supported; configure the client ID explicitly

What can it do?

The MCP server exposes the everyday Boards actions as tools for the assistant:

  • find your boards, and search cards, people and groups
  • read a board's lists, cards, labels and members
  • create boards, lists and cards
  • update cards: edit fields, move between lists, assign people, set due dates, mark complete
  • add comments and attachments
  • see what is assigned to you across all boards

Some example prompts:

  • "What's assigned to me this week across my boards?"
  • "Create a card 'Prepare Q3 report' in the To Do list of the Marketing board and assign it to me."
  • "Summarise the outstanding tasks on the Website Redesign board."
  • "Move everything I've finished in Sprint 12 to the Done list."