Skip to content

Claude Code

Work with your boards from Claude Code using natural language. The official huddo-boards plugin connects Claude to the Boards MCP server, so you can ask Claude to find boards, read and create cards, move and assign tasks, complete work and add comments — from the terminal, IDE or Claude Code desktop app.

The plugin is open source: isw-kudos/huddo-claude-plugin.

Info

Using claude.ai, Claude Desktop or another MCP client instead? See AI Assistants (MCP) for direct connection details.

Install

Add the Huddo plugin marketplace and install the plugin:

claude plugin marketplace add isw-kudos/huddo-claude-plugin

claude plugin install huddo-boards@huddo

Sign in

The Boards MCP server uses OAuth. In a Claude Code session, run /mcp, select huddo-boards and complete the browser sign-in with your Boards account. Claude only ever acts with your own Boards permissions.

Note

On install, Claude Code may report 1 userConfig option not yet set. This is informational — the plugin defaults to Huddo Cloud (https://boards.api.huddo.com/mcp) and works with no configuration. Only self-hosted deployments need to change it.

What you can do

Some examples of what to ask once connected:

  • "What's on my plate today?" — lists tasks assigned to you
  • "Show me the In Progress column on the Marketing board"
  • "File a card on the Support board: login page slow on Safari, with what we found"
  • "Move the release-notes task to Done and comment that it shipped in 2.4"
  • "Create a board for the Q4 campaign from our campaign template"

The plugin also ships a skill that teaches Claude the Boards data model (boards, lists, cards, groups, assignments), so it uses the API efficiently without being told how.

Self-hosted deployments

The MCP endpoint is a plugin setting. Point it at your own deployment when prompted during install, or afterwards:

claude plugin configure huddo-boards@huddo

Two requirements on the deployment side:

  1. The Boards mcp service must be deployed and reachable.
  2. Your user service must have the boards-mcp OAuth client registered — a public PKCE client with http://localhost:*/callback redirect URIs. The OAuth client id is fixed; only the endpoint is configurable.

Info

The MCP service is currently available on Huddo Cloud. Availability for self-hosted distributions is coming — contact us if you would like it for your deployment.

Troubleshooting

Plugin server does not appear

If you previously added huddo-boards as a manual MCP server (claude mcp list shows it outside the plugin), Claude Code silently prefers it over the plugin's server with the same URL. Remove it with claude mcp remove huddo-boards, then restart Claude Code.

Sign-in fails after changing configuration

Claude Code caches OAuth client details per server after the first sign-in attempt. If sign-in keeps failing after a configuration fix, clear the server's authentication from the /mcp menu and sign in again in a fresh session.

For anything else, contact us.