github-stars-contributions-mcp

💽 MCP server to update your GitHub Stars contributions

public

Forked

⭐ GitHub Stars Contributions MCP

An MCP (Model Context Protocol) server for managing your GitHub Stars contributions and profile - so AI assistants like Claude Desktop and Cursor can help you track your community contributions through natural language.

✨ Features

Contribution management

Add contribution — Add talks, blog posts, videos, and other contributions
Update contribution — Modify existing contributions
Remove contribution — Delete contributions from your profile
List contributions — Retrieve all your contributions with pagination

Profile links

Add link — Add social/platform links to your profile
Remove link — Delete profile links
List links — Get all your profile links

Query tools

Get public profile — View any GitHub Star’s public profile
Search Stars — Browse GitHub Stars directory
Get logged user — View your own profile information

📋 Prerequisites

Node.js v18 or later
GitHub Stars API token — Get yours from stars.github.com/profile under the “Token” tab

🚀 Quick start

Add the server to your MCP config:

Cursor IDE

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "github-stars": {
      "command": "npx",
      "args": ["-y", "github-stars-contributions-mcp"],
      "env": {
        "GITHUB_STARS_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "github-stars": {
      "command": "npx",
      "args": ["-y", "github-stars-contributions-mcp"],
      "env": {
        "GITHUB_STARS_TOKEN": "your-api-token-here"
      }
    }
  }
}

Get your API token

Go to stars.github.com/profile
Navigate to the Token tab
Copy your API token and replace your-api-token-here in the config above

⚙️ Alternative installation

From source

If you prefer to run from source:

git clone https://github.com/AnandChowdhary/github-stars-contributions-mcp.git
cd github-stars-contributions-mcp
npm install

Then use this config:

{
  "mcpServers": {
    "github-stars": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-stars-contributions-mcp/github-stars-contributions-mcp.mjs"
      ],
      "env": {
        "GITHUB_STARS_TOKEN": "your-api-token-here"
      }
    }
  }
}

Running standalone

export GITHUB_STARS_TOKEN="your-api-token-here"
npx github-stars-contributions-mcp

🎯 Available tools

`add_contribution`

Add a new contribution to your GitHub Stars profile.

Parameter	Type	Required	Description
`type`	enum	✅	`SPEAKING`, `BLOGPOST`, `ARTICLE_PUBLICATION`, `EVENT_ORGANIZATION`, `HACKATHON`, `OPEN_SOURCE_PROJECT`, `VIDEO_PODCAST`, `FORUM`, `OTHER`
`title`	string	✅	Title of the contribution
`description`	string	✅	Description of the contribution
`date`	string	✅	Date in `YYYY-MM-DD` or ISO format
`url`	string	❌	URL related to the contribution

`update_contribution`

Update an existing contribution.

Parameter	Type	Required	Description
`id`	string	✅	ID of the contribution to update
`type`	enum	❌	Contribution type
`title`	string	❌	Title
`description`	string	❌	Description
`date`	string	❌	Date
`url`	string	❌	URL

`remove_contribution`

Delete a contribution from your profile.

Parameter	Type	Required	Description
`id`	string	✅	ID of the contribution to delete

`list_contributions`

Get all your contributions.

Parameter	Type	Required	Description
`first`	number	❌	Number of items to fetch
`offset`	number	❌	Pagination offset

`add_link`

Add a profile link.

Parameter	Type	Required	Description
`link`	string	✅	URL of the link
`platform`	enum	✅	`TWITTER`, `MEDIUM`, `LINKEDIN`, `README`, `STACK_OVERFLOW`, `DEV_TO`, `MASTODON`, `OTHER`

`remove_link`

Delete a profile link.

Parameter	Type	Required	Description
`id`	string	✅	ID of the link to delete

`list_links`

Get all your profile links. No parameters required.

`get_public_profile`

Get a GitHub Star’s public profile.

Parameter	Type	Required	Description
`username`	string	✅	GitHub username

`search_stars`

Search GitHub Stars.

Parameter	Type	Required	Description
`featured`	boolean	❌	Filter to featured Stars only

`get_logged_user`

Get your own profile information. No parameters required.

📝 Example usage

Once configured with your AI assistant, you can use natural language:

“Add my talk at GitHub Universe as a speaking contribution”
“List all my contributions from this year”
“Add my Twitter profile link”
“Show me the public profile of octocat”
“Remove the contribution with ID abc123”

📊 Contribution types

Type	Description
`SPEAKING`	Conference talks, meetups, webinars
`BLOGPOST`	Blog posts and tutorials
`ARTICLE_PUBLICATION`	Published articles in magazines/journals
`EVENT_ORGANIZATION`	Organizing events, meetups, conferences
`HACKATHON`	Hackathon participation or mentoring
`OPEN_SOURCE_PROJECT`	Open source contributions
`VIDEO_PODCAST`	YouTube videos, podcasts
`FORUM`	Forum contributions, Q&A
`OTHER`	Any other contribution type

🔗 Platform types

Type	Description
`TWITTER`	Twitter/X profile
`MEDIUM`	Medium blog
`LINKEDIN`	LinkedIn profile
`README`	README profile
`STACK_OVERFLOW`	Stack Overflow profile
`DEV_TO`	DEV Community profile
`MASTODON`	Mastodon profile
`OTHER`	Any other platform

🔧 Troubleshooting

“GITHUB_STARS_TOKEN environment variable is required”

Make sure you’ve set the GITHUB_STARS_TOKEN in your MCP configuration or exported it in your shell.

“Unauthorized” errors

Your API token may have expired. Generate a new one from stars.github.com/profile.

Server not connecting

Ensure Node.js v18+ is installed
Check that the GITHUB_STARS_TOKEN is set correctly
Restart your AI assistant after config changes

github-stars-contributions CLI — CLI tool by Ahmad Awais
GitHub Stars Program — Official GitHub Stars website

📃 License

Find me

v0.3.1[beta]