Skip to main content
Glama
romeldev
by romeldev

gh-board-mcp

MCP server for managing GitHub Projects v2 as a personal kanban board. Create activities (draft items), move them between columns, track priority — without linking to real issues.

Requirements

Related MCP server: GitHub Projects MCP Server

Usage

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Configure it in your MCP client (e.g. Claude Code):

claude mcp add gh-board-mcp -- env GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Tools

Tool

Description

list_projects

List your GitHub Projects v2 boards

create_project

Create a new board (default Status + Priority fields)

list_activities

List activities (draft items), filter by status/priority

create_activity

Create an activity with optional status/priority

move_activity

Move an activity to another status (and set priority)

update_activity

Edit an activity's title/description

delete_activity

Delete an activity

Status & Priority

  • create_project creates a new board with Status = Todo / In Progress / Done and Priority = Urgent / High / Medium / Low.

  • Boards created from a GitHub template keep their own Status/Priority options — pass values that exist on the board. create_activity, move_activity, and list_activities report the valid options when given an unknown value.

  • Custom columns are not supported via the API (configure them in the GitHub UI).

Notes

  • Read cap: list_activities and list_projects read up to 100 items / projects in one call; larger boards are truncated.

  • Eventual consistency: GitHub Projects v2 writes can take a moment to appear in reads — a list_activities immediately after create_activity may briefly miss the new item.

  • Create is not atomic: create_activity validates the status/priority options before creating, so a bad option leaves nothing behind; a transient network error mid-create can still leave a draft without its field values.

Development

npm install
npm test
npm run build
npm run dev

License

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Shortcut project management. Create, update, search stories and manage workflows.

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/romeldev/gh-board-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server