Skip to main content
Glama

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

Related MCP server: TypeScript Tools MCP

Configuration

Create a .env file in your working directory:

CODECKS_TOKEN=your_session_cookie
CODECKS_ACCOUNT=your_account_slug

Tokens

Variable

Source

Expires

CODECKS_TOKEN

Browser DevTools > Cookie at

Yes

CODECKS_REPORT_TOKEN

CLI generate-token command

No

CODECKS_ACCOUNT

Your Codecks account slug

N/A

CODECKS_USER_ID

Auto-discovered if unset

N/A

Optional Settings

Variable

Default

Description

CODECKS_MCP_RESPONSE_MODE

legacy

legacy or envelope

CODECKS_HTTP_TIMEOUT_SECONDS

30

Request timeout

CODECKS_HTTP_MAX_RETRIES

2

Retry count

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)

Tool

Description

get_account

Current account info

list_cards

List/filter cards with pagination

get_card

Full card details

list_decks

All decks

list_projects

Projects with decks

list_milestones

Milestones

list_tags

Project-level tags

list_activity

Recent activity feed

pm_focus

PM dashboard (blocked, stale, suggested)

standup

Daily standup summary

Hand (3)

Tool

Description

list_hand

Personal work queue

add_to_hand

Add cards to hand

remove_from_hand

Remove cards from hand

Mutation (9)

Tool

Description

create_card

Create card (supports sub-cards)

update_cards

Batch update properties

mark_done

Mark cards done

mark_started

Mark cards started

archive_card

Archive (reversible)

unarchive_card

Restore archived

delete_card

Permanent delete

scaffold_feature

Hero + lane sub-cards

split_features

Batch-split features

Comments (5)

Tool

Description

create_comment

Start thread

reply_comment

Reply to thread

close_comment

Resolve thread

reopen_comment

Reopen thread

list_conversations

List threads

PM Session (3)

Tool

Description

get_pm_playbook

Methodology guide

get_workflow_preferences

Load preferences

save_workflow_preferences

Save preferences

Feedback (2)

Tool

Description

save_cli_feedback

Save feedback

get_cli_feedback

Read feedback

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

License

MIT

Available Tools

38 tools
add_to_handAdd to HandC

Add cards to the user's hand.

Inputs: card_ids (required).

archive_cardArchive CardA

Archive a card (reversible).

Inputs: card_id (required).

close_commentClose CommentC

Close (resolve) a comment thread.

Inputs: thread_id (required), card_id (required).

create_cardCreate CardB

Create a new card. Set deck/project to place it. Use parent to nest as sub-card.

Inputs: title (required), content, deck, project, +4 more.

create_commentCreate CommentC

Start a new comment thread on a card.

Inputs: card_id (required), message (required).

delete_cardDelete CardA

Permanently delete a card. Cannot be undone — use archive_card if reversibility needed.

Inputs: card_id (required).

get_accountGet AccountB

Get current account info (name, id, email, role).

Inputs: no named parameters.

get_cardGet CardC

Get full card details (content, checklist, sub-cards, conversations, hand status).

Inputs: card_id (required), include_content, include_conversations, archived.

get_cli_feedbackGet CLI FeedbackA

Read saved CLI feedback items. Optionally filter by category. No auth needed.

Inputs: category.

get_lane_registryGet Lane RegistryB

Get the local lane (deck category) definitions and metadata. No auth needed.

Inputs: required_only.

get_pm_playbookGet PM PlaybookB

Get PM session methodology guide. No auth needed.

Inputs: no named parameters.

get_tag_registryGet Tag RegistryA

Get the local tag taxonomy (definitions, hero tags, lane-tag mappings). No auth needed.

Inputs: category.

get_workflow_preferencesGet Workflow PreferencesA

Load user workflow preferences from past sessions. No auth needed.

Inputs: no named parameters.

list_activityList ActivityC

Show recent activity feed.

Inputs: limit.

list_cardsList CardsC

List cards. Filters combine with AND.

Inputs: deck, status, project, search, +15 more.

list_conversationsList ConversationsC

List all comment threads on a card with messages and thread IDs.

Inputs: card_id (required).

list_decksList DecksB

List all decks. Set include_card_counts=True for per-deck counts.

Inputs: include_card_counts.

list_handList HandB

List cards in the user's hand (personal work queue), sorted by hand order.

Inputs: no named parameters.

list_milestonesList MilestonesB

List all milestones with card counts.

Inputs: no named parameters.

list_projectsList ProjectsB

List all projects with deck info.

Inputs: no named parameters.

list_tagsList TagsB

List project-level tags (sanctioned taxonomy).

Inputs: no named parameters.

mark_doneMark DoneC

Mark cards as done.

Inputs: card_ids (required).

mark_startedMark StartedC

Mark cards as started.

Inputs: card_ids (required).

planning_initPlanning InitA

Create lean planning files (task_plan.md, findings.md, progress.md) in project root. No auth needed.

Inputs: force.

planning_measurePlanning MeasureA

Track token usage of planning files over time. No auth needed. Operations: snapshot, report, compare_templates.

Inputs: operation (required).

planning_statusPlanning StatusB

Get compact planning status: goal, phases, decisions, errors, token count. No auth needed.

Inputs: no named parameters.

planning_updatePlanning UpdateC

Update planning files mechanically. No auth needed. Operations: goal, advance, phase_status, error, decision, finding, issue, log, file_changed, test.

Inputs: operation (required), text, phase, status, +7 more.

pm_focusPM FocusC

PM focus dashboard: blocked, stale, unassigned, and suggested next cards.

Inputs: project, owner, limit, stale_days.

remove_from_handRemove from HandC

Remove cards from the user's hand.

Inputs: card_ids (required).

reopen_commentReopen CommentC

Reopen a closed comment thread.

Inputs: thread_id (required), card_id (required).

reply_commentReply CommentC

Reply to an existing comment thread.

Inputs: thread_id (required), message (required).

save_cli_feedbackSave CLI FeedbackC

Save a CLI feedback item for the development team. No auth needed.

Inputs: category (required), message (required), tool_name, context.

save_workflow_preferencesSave Workflow PreferencesB

Save observed workflow patterns from current session. No auth needed.

Inputs: observations (required).

scaffold_featureScaffold FeatureC

Create a Hero card with Code/Design/Art/Audio sub-cards.

Inputs: title (required), hero_deck (required), code_deck (required), design_deck (required), +9 more.

split_featuresSplit FeaturesB

Batch-split unsplit feature cards into lane sub-cards. Use dry_run=true to preview.

Inputs: deck (required), code_deck (required), design_deck (required), art_deck, +5 more.

standupStandupC

Daily standup summary: recently done, in-progress, blocked, and hand.

Inputs: days, project, owner.

unarchive_cardUnarchive CardB

Restore an archived card.

Inputs: card_id (required).

update_cardsUpdate CardsB

Update card properties. Doc cards: only owner/tags/milestone/deck/title/content/hero.

Inputs: card_ids (required), status, priority, effort, +9 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 38 tools

    Disambiguation3/5

    Most tools have distinct purposes, but some overlap exists. For example, 'list_cards' and 'list_hand' both list cards, with the latter being a filtered subset, which could cause confusion. Similarly, 'mark_done' and 'mark_started' are clear, but 'archive_card' and 'delete_card' are distinguished by reversibility, which might not be immediately obvious. Overall, descriptions help clarify, but there is moderate overlap in card-related operations.

    Naming Consistency4/5

    Tool names follow a consistent verb_noun pattern throughout, such as 'create_card', 'list_cards', and 'update_cards'. Minor deviations include 'scaffold_feature' and 'split_features', which use slightly different verbs but maintain readability. The naming is largely predictable, with only a few tools breaking the pattern without causing significant confusion.

    Tool Count2/5

    With 38 tools, the count is excessive for a project management server, making it feel heavy and potentially overwhelming. While the domain is broad, many tools could be consolidated or omitted without losing functionality. This high number increases complexity and reduces usability for agents, indicating poor scoping.

    Completeness5/5

    The tool set provides comprehensive coverage for project management tasks, including CRUD operations for cards, comments, and planning, along with workflow utilities and reporting. It supports full lifecycle management from creation to archiving, with no apparent gaps. The inclusion of planning, feedback, and preference tools ensures agents can handle all core workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A TypeScript-based MCP server that provides tools to interact with local Codex and Gemini CLIs via stdio transport. It enables users to execute prompts through the ask_codex and ask_gemini tools, supporting custom models and timeout configurations.
      1
      11 npm
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server that provides 40 tools for TypeScript/JavaScript refactoring and code intelligence, directly mapping to TypeScript's tsserver protocol commands for accurate structural changes and workspace analysis.
      40
      29 npm
      3
      MIT