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-mcp

Configuration

Create a .env file in your working directory:

CODECKS_TOKEN=your_session_cookie
CODECKS_ACCOUNT=your_account_slug

Tokens

Optional Settings

Transports

stdio (default)

codecks-mcp

HTTP

codecks-mcp --transport http --port 3000

Endpoints:

• 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)

Hand (3)

Mutation (9)

Comments (5)

PM Session (3)

Feedback (2)

Security

• Prompt injection detection (6 regex patterns)
• [USER_DATA] boundary tagging on user-authored content
• Input 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 typecheck

Also Available

• Python version: codecks-mcp-python — same tools, Python runtime
• Full CLI: codecks-cli — CLI + library with formatters, GDD sync, and more

License

MIT