Copilot Usage

Provides current GitHub Copilot usage data, quotas, limits, and statistics via MCP for monitoring and automation.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lucasliet-copilot-usage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "copilot-usage-mcp"
      ],
      "env": {
        "COPILOT_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

This MCP server provides real-time information about your GitHub Copilot usage, including quotas, limits, and usage statistics. It helps you monitor your Copilot plan, understand how you’re consuming tokens, and plan your interactions with Copilot more effectively by exposing usage data to your preferred MCP clients.

How to use

You interact with this server through an MCP client to query your Copilot usage data. After you configure a client to connect to the MCP server, you can request raw usage data, formatted usage details in your preferred language, or a concise usage summary. Your client can then present this information in natural language prompts or integrated UI.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Option 1 — Install via NPM (quick start) — run this command directly:

npx -y copilot-usage-mcp

Option 2 — Install locally for development — follow these steps, then run the server locally:

# Clone the repository
git clone <url-do-repositorio>
cd copilot-usage-mcp

# Install dependencies
npm install

# Execute the server locally
npx -y -p "path_do_projeto" copilot-usage-mcp

Configuration and security

To access Copilot usage data, you must provide a valid GitHub Copilot access token. You can obtain this token through supported workflows and store it securely in your MCP client configuration.

Environment variable to provide in MCP client configurations:

{"COPILOT_TOKEN": "seu_token_aqui"}

Usage with MCP clients

Configure your MCP client to run the server and pass the Copilot token as an environment variable. Examples below show how to integrate with popular agents.

Claude Code example (adjust the token value before use):

claude mcp add --scope user copilot-usage --env COPILOT_TOKEN="seu_token_aqui" -- npx -y copilot-usage-mcp

Gemini CLI example (adjust the token value before use):

gemini mcp add copilot-usage npx -y copilot-usage-mcp -e COPILOT_TOKEN="seu_token_aqui"

Claude Desktop / Cursor configuration snippet (copy into claude_desktop_config.json):

{
  "mcpServers": {
    "copilot-usage": {
      "command": "npx",
      "args": ["-y", "copilot-usage-mcp"],
      "env": {
        "COPILOT_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Available MCP tools and endpoints

The server exposes tools to fetch and format Copilot usage data. You can use them through your MCP client to obtain raw usage data, formatted usage details, or a concise usage summary.

Available tools

get_copilot_usage

Retrieves raw GitHub Copilot usage information in JSON format for programmatic processing.

get_copilot_usage_formatted

Retrieves Copilot usage information in a human-friendly, readable format.

get_copilot_usage_summary

Provides a concise summary of primary Copilot usage metrics and quotas.