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-mcpshow me my daily standup summary"
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
TypeScript MCP server for Codecks project management. Exposes 32+ tools for managing cards, decks, milestones, tags, and PM workflows via the Model Context Protocol.
Built with @modelcontextprotocol/server, zod, and Express.
Quick Start
# Run directly (no install needed)
npx codecks-mcp
# Or install globally
npm install -g codecks-mcp
codecks-mcpConfiguration
Create a .env file in your working directory:
CODECKS_TOKEN=your_session_cookie
CODECKS_ACCOUNT=your_account_slugTokens
Variable | Source | Expires |
| Browser DevTools > Cookie | Yes |
| CLI | No |
| Your Codecks account slug | N/A |
| Auto-discovered if unset | N/A |
Optional Settings
Variable | Default | Description |
|
|
|
|
| Request timeout |
|
| Retry count |
Transports
stdio (default)
codecks-mcpHTTP
codecks-mcp --transport http --port 3000Endpoints:
POST /mcp— MCP protocol (Streamable HTTP)GET /ping— Health check
IDE Setup
Claude Code
{
"mcpServers": {
"codecks": {
"command": "npx",
"args": ["-y", "codecks-mcp"]
}
}
}Cursor
{
"mcpServers": {
"codecks": {
"command": "npx",
"args": ["-y", "codecks-mcp"]
}
}
}Remote (HTTP)
{
"mcpServers": {
"codecks": {
"url": "http://localhost:3000/mcp"
}
}
}Tools
Read (10)
Tool | Description |
| Current account info |
| List/filter cards with pagination |
| Full card details |
| All decks |
| Projects with decks |
| Milestones |
| Project-level tags |
| Recent activity feed |
| PM dashboard (blocked, stale, suggested) |
| Daily standup summary |
Hand (3)
Tool | Description |
| Personal work queue |
| Add cards to hand |
| Remove cards from hand |
Mutation (9)
Tool | Description |
| Create card (supports sub-cards) |
| Batch update properties |
| Mark cards done |
| Mark cards started |
| Archive (reversible) |
| Restore archived |
| Permanent delete |
| Hero + lane sub-cards |
| Batch-split features |
Comments (5)
Tool | Description |
| Start thread |
| Reply to thread |
| Resolve thread |
| Reopen thread |
| List threads |
PM Session (3)
Tool | Description |
| Methodology guide |
| Load preferences |
| Save preferences |
Feedback (2)
Tool | Description |
| Save feedback |
| Read feedback |
Security
Prompt injection detection (6 regex patterns)
[USER_DATA]boundary tagging on user-authored contentInput validation with zod schemas + length limits
UUID validation on all card IDs
Control character stripping
Development
# Install
pnpm install
# Dev mode (tsx, auto-reload)
pnpm dev
# Build
pnpm build
# Test
pnpm test
# Lint + format
pnpm lint
pnpm format:check
# Type check
pnpm typecheckAlso Available
Python version: codecks-mcp-python — same tools, Python runtime
Full CLI: codecks-cli — CLI + library with formatters, GDD sync, and more
License
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.