AI Agent Integration
Connect Gemini CLI to Kanboard
Gemini CLI is Google's coding agent for the terminal. Connect it to Kanboard's remote MCP server and it can read your board, create tasks, and move work across columns as it ships — nothing to host, nothing to babysit.
1. Create an API key
Go to Settings → Integrations in Kanboard and create an API key. Keys require a Pro subscription. Copy the key — it's shown once.
2. Add the server to Gemini CLI
~/.gemini/settings.json (user) or .gemini/settings.json (project)
{
"mcpServers": {
"kanboard": {
"httpUrl": "https://kanboard.io/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" },
"timeout": 30000
}
}
}Or via the CLI
gemini mcp add -t http kanboard https://kanboard.io/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY"3. Verify it works
- Run /mcp inside Gemini CLI — kanboard should show CONNECTED with its tool list.
Then put the agent to work:
- “Look at my Kanboard board and pick up the top task in To Do.”
- “Break this feature into tasks and add them to my board.”
- “Move everything you finished today to Done.”
Good to know
- Streamable HTTP uses httpUrl — a plain url field silently means SSE and won't connect to Kanboard.
- "trust": true on the server entry skips per-tool confirmations once you're comfortable.
Full client documentation: Gemini CLI MCP docs
Available tools
| get_board | Full snapshot of a project's columns and tasks |
| list_projects | List all your projects |
| create_project | Create a project with default columns |
| list_tasks | List tasks, optionally by project |
| get_task | Read a task with its description |
| create_task | Add a task to any column |
| update_task | Edit a task's title or description |
| move_task | Move a task across columns |
| delete_task | Remove a task |
FAQ
Does Gemini CLI support remote MCP servers?
Yes — Gemini CLI supports Streamable HTTP MCP servers with custom headers via the httpUrl field.
Do I need to install anything?
Nothing beyond Gemini CLI. The server is remote — one settings.json entry or one gemini mcp add command.
Is the MCP server included in Kanboard's subscription?
Yes. The MCP server and REST API are included in Pro, Kanboard's single plan at $12/month (or $96/year) with unlimited projects and tasks.
What can Gemini CLI do on my Kanboard board?
Everything the MCP server exposes: list projects, snapshot a board, and create, read, update, move, and delete tasks. A typical flow: you plan tasks in To Do, the agent picks one up, moves it to In Progress, does the work, and moves it to Done.
Where do I get the API key?
Settings → Integrations in Kanboard. Keys require a Pro subscription and are shown once — copy it straight into the config.