Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Codecks MCP ServerCreate a new card for the inventory bug fix in the Backlog deck"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Codecks MCP Server
An MCP (Model Context Protocol) server that lets AI assistants interact with Codecks project management. Query cards, create tasks, update status, and manage your game dev workflow directly from Claude or other MCP-compatible AI tools.
Repository: github.com/microkorg/Codecks-MCP
Features
List & Search Cards - Query all cards or filter by deck/project/status, search by title/content
Create Cards & Decks - Add new tasks directly from your AI assistant, reference decks by name or ID
Update Cards - Modify card content, move between decks, rename decks
Status Management - Mark cards complete, archive/unarchive finished work
Space Management - List, create, rename, and delete spaces (deck containers)
Flexible Project Filtering - Set a default project or specify per-call for cross-project workflows
Prerequisites
Quick Start
Then run the setup script for your platform:
Windows:
setup.batMac/Linux:
bash setup.sh
This installs dependencies and creates your .env config file. See Configuration below for how to find your token and user ID.
Configuration
Edit .env with your Codecks credentials:
Finding Your Token
Open your Codecks organization in your browser
Press F12 to open Developer Tools
Go to Application tab > Cookies > your codecks domain
Find the cookie named
atand copy its value
Finding Your User ID
Open Developer Tools (F12) > Network tab
Create any card in Codecks
Find the request to
api.codecks.io/dispatch/cards/createLook at the request payload - the
userIdfield is your user ID
Usage with Claude Code
Add to your .claude/settings.json:
Optionally, prevent Claude from reading your credentials:
Available Tools
Cards
Tool | Description |
| List all cards, optionally filter by deck name, project, and/or status |
| Search cards by title or content |
| Get a specific card by ID |
| Create a new card in a deck (by ID or name) |
| Update card content |
| Move a card to a different deck |
| Mark a card as complete or incomplete |
| Archive a card |
| Unarchive a card, making it visible again |
Decks
Tool | Description |
| List all decks in a project with card counts and space info |
| Create a new deck, optionally in a specific space |
| Rename a deck |
Spaces
Tool | Description |
| List all spaces in a project |
| Create a new space (deck container) |
| Rename a space |
| Delete a space (cannot delete the default space) |
Projects
Tool | Description |
| List all projects in your organization |
| Create a new project |
Example Prompts
Once configured, you can ask Claude things like:
"What cards are in my backlog?"
"Show me all started cards"
"Create a card for implementing the save system in the Ideas deck"
"Mark the authentication card as complete"
"Move the UI polish card to the In Progress deck"
"Show me all cards in the other project"
"Create a deck called 'Sprint 1' in the Design space"
"What spaces are in this project?"
"Rename the Art deck to Art Assets"
Token Expiration
The at cookie token may expire. If you start getting authentication errors, grab a fresh token from your browser cookies.
License
MIT