Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITHUB_TOKEN | Yes | GitHub personal access token with access to Projects (V2) and the GraphQL API. |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_projects | List GitHub Projects V2 for a given organization or user. Args:
owner: The GitHub organization or user name
Returns:
A formatted string with project details |
| get_project_fields | Get fields available in a GitHub Project V2, including options for SingleSelect fields. Args:
owner: The GitHub organization or user name
project_number: The project number
Returns:
A formatted string with field details. |
| get_project_items | Get items in a GitHub Project V2. Can filter by state OR a single custom field=value. Args:
owner: The GitHub organization or user name
project_number: The project number
limit: Maximum number of items to return (default: 50). When filtering, the system automatically fetches more items to improve efficiency.
state: Optional state filter (e.g., "OPEN", "CLOSED"). Applies to Issues/PRs.
filter_field_name: Optional custom field name to filter by (e.g., "Status"). Currently supports SingleSelect and Iteration fields.
filter_field_value: Optional custom field value to filter by (e.g., "In Development"). Uses case-insensitive matching.
cursor: Optional cursor for pagination. Use value from previous results to get next page.
Returns:
A formatted string with item details. |
| create_issue | Create a new GitHub issue. Args:
owner: The GitHub organization or user name
repo: The repository name
title: The issue title
body: The issue body (optional)
Returns:
A formatted string with the created issue details |
| add_issue_to_project | Add an existing GitHub issue to a Project V2. Args:
owner: The GitHub organization or user name that owns the project
project_number: The project number
issue_owner: The owner of the repository containing the issue
issue_repo: The repository name containing the issue
issue_number: The issue number
Returns:
A formatted string confirming the addition |
| update_project_item_field | Update a field value for a project item. Args:
owner: The GitHub organization or user name
project_number: The project number
item_id: The ID of the item to update
field_id: The ID of the field to update
field_value: The new value for the field (text, date, or option ID for single select)
Returns:
A confirmation message |
| create_draft_issue | Create a draft issue directly in a GitHub Project V2. Args:
owner: The GitHub organization or user name
project_number: The project number
title: The draft issue title
body: The draft issue body (optional)
Returns:
A confirmation message with the new draft issue details |
| delete_project_item | Delete an item from a GitHub Project V2. Args:
owner: The GitHub organization or user name
project_number: The project number
item_id: The ID of the item to delete
Returns:
A confirmation message |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |