Configuration
Once the GitHub connection is validated, configuration defines how MCP Express exposes GitHub board operations as callable tools. Most actions require a project identifier and may optionally target items, issues, or draft entries depending on the tool.
Action Configuration
Use action configuration to define which project operation the tool performs and which parameters are resolved at runtime.
Supported Actions
The following actions are supported by the GitHub Board integration:
- Archive Item: Archive an item in a project board.
- Create Item: Create a new item in a project board.
- Create Project: Create a new project board.
- Delete Item: Delete an item from a project board.
- Get Item Details: Retrieve details for a specific item in a project board.
- Get Project: Retrieve details for a specific project board.
- List Items: List items in a project board.
- List Projects: List all project boards for the owner.
- Update Item Status: Update the status of an item in a project board.
Common Runtime Parameters
Use the following parameters according to the configured action.
| Parameter | Required | Description |
|---|---|---|
| Project number | Some | The GitHub Projects number. Required for most project-scoped actions. |
| Item ID | Some | Unique identifier for a project item. Required for item-specific actions such as updates or retrieval. |
| Item type | Some | Item type to create. Supported values are draft or issue. |
| Title | Some | Title for a new project or item. Commonly required for create actions. |
| Repo | Some | Repository name. Required when the action references an issue in a repository. |
| Body | No | Optional body or description for new draft items or project content. |
| First | No | Maximum number of items to return. Default is 20; maximum is 100. |
Governance Controls
Give only access to project scope when creating classic token. Do not reuse old token with extended permission or extend permission for this token. Use it strictly for mcp-express github board integration.
Use the built-in testing utility to verify key resolution ({{ }} substitution), required attribute presence, and permission behavior before production using it in you client.