add_card_to_column
Add a card containing an issue, pull request, or note to a specific project column in a GitHub repository. Specify the owner, repo, column ID, and content type for precise placement.
Instructions
Add a new card to a project column
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| column_id | Yes | The ID of the column to add card to | |
| content_id | No | ID of the issue or pull request (required if content_type is Issue or PullRequest) | |
| content_type | Yes | Type of content for the card | |
| note | No | The note content for the card (required if content_type is Note) | |
| owner | Yes | Repository owner (username or organization) | |
| repo | Yes | Repository name |
Implementation Reference
- operations/projects.ts:327-371 (handler)Core implementation of the add_card_to_column tool: validates inputs, constructs payload, and makes POST request to GitHub API to add card to column.
export async function addCardToColumn( owner: string, repo: string, columnId: string, contentType: string, contentId?: number, note?: string ) { try { const payload: any = {}; if (contentType === 'Note') { if (!note) { throw new GitHubError('Note content is required when content_type is Note', 400, { message: 'Missing note content' }); } payload.note = note; } else { if (!contentId) { throw new GitHubError('Content ID is required when content_type is Issue or PullRequest', 400, { message: 'Missing content ID' }); } const actualContentType = contentType.toLowerCase(); payload.content_id = contentId; payload.content_type = actualContentType; } const url = `https://api.github.com/projects/columns/${columnId}/cards`; const response = await githubRequest(url, { method: 'POST', body: payload, headers: { 'Accept': 'application/vnd.github.inertia-preview+json' } }); return response; } catch (error) { if (error instanceof GitHubError) { throw error; } throw new GitHubError(`Failed to add card to column: ${(error as Error).message}`, 500, { error: (error as Error).message }); } } - operations/projects.ts:64-71 (schema)Zod schema defining input parameters for the add_card_to_column tool.
export const AddCardToColumnSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), column_id: z.string().describe("The ID of the column to add card to"), content_type: z.enum(["Issue", "PullRequest", "Note"]).describe("Type of content for the card"), content_id: z.number().optional().describe("ID of the issue or pull request (required if content_type is Issue or PullRequest)"), note: z.string().optional().describe("The note content for the card (required if content_type is Note)"), }); - index.ts:246-249 (registration)Registers the add_card_to_column tool in the MCP server tool list, including name, description, and input schema.
name: "add_card_to_column", description: "Add a new card to a project column", inputSchema: zodToJsonSchema(projects.AddCardToColumnSchema), }, - index.ts:674-687 (handler)Top-level handler case in the MCP tool dispatcher that parses arguments and delegates to the projects.addCardToColumn implementation.
case "add_card_to_column": { const args = projects.AddCardToColumnSchema.parse(request.params.arguments); const result = await projects.addCardToColumn( args.owner, args.repo, args.column_id, args.content_type, args.content_id, args.note ); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }