TaskPilot MCP

A Model Control Protocol implementation for VS Code Copilot that extends GitHub Copilot with additional tools for Jira, Git, Calendar, and Slack integrations. This will be used within an organisation.

Installation

# Install globally (recommended)
npm install -g taskpilot-mcp

# Or install locally in your project
npm install taskpilot-mcp

VS Code Copilot Integration

The TaskPilot MCP server runs automatically when requested by VS Code Copilot. No manual code initialization is required.

Simply add this to your VS Code settings (settings.json):

For global installation (recommended)

"github.copilot.advanced": {
  "model.contextProtocol.server.path": "taskpilot-mcp"
}

For local project installation

"github.copilot.advanced": {
  "model.contextProtocol.server.path": "${workspaceFolder}/node_modules/.bin/taskpilot-mcp"
}

Configuration

Option 1: Using VS Code Settings (Recommended)

Configure environment variables directly in VS Code settings.json:

"mcp": {
  "servers": {
    "taskpilot-mcp": {
      "type": "stdio",
      "command": "node", // add exact node path if using nvm (should be greater that 16.0.0)
      "args": [
        "{workspaceFolder}/node_modules/.bin/taskpilot-mcp"
      ],
      "env": {
        "USER_SLACK_TOKEN": "xoxb-your-slack-bot-token",
        "SLACK_SIGNING_SECRET": "your-slack-signing-secret",
        "JIRA_URL": "your-company.atlassian.net",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_USER_EMAIL": "[email protected]",
        "GOOGLE_CLIENT_ID": "your-google-client-id",
        "GOOGLE_CLIENT_SECRET": "your-google-client-secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback",
        "GOOGLE_REFRESH_TOKEN": "your-google-refresh-token",
        "GITHUB_AUTH_TOKEN": "your-auth-token",
        "GITHUB_USERNAME": "github-username",
        "GITHUB_OWNER": "github org name",
        "GITHUB_REPO": "github-repo"
      }
    }
  }
}

Option 2: Using .env File

Create a .env file in your project directory with the following variables:

# Jira Configuration
JIRA_URL=your-company.atlassian.net
JIRA_API_TOKEN=your_jira_api_token
[email protected]

# Slack Configuration
USER_SLACK_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your_slack_signing_secret

# Google Calendar Configuration
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback
GOOGLE_REFRESH_TOKEN=your_google_refresh_token

Features

• Jira Integration: Query and update Jira tickets directly from Copilot
• Git Tools: Interact with your Git repositories
• Calendar Integration: Schedule meetings and check availability
• Slack Integration: Send messages and create channels

Security Note

This package uses environment variables for configuration. Never commit your .env file or hard-code sensitive tokens in your code.

License

MIT