stargate-mcp

Personal MCP server toolkit for AI agents. Integrates with Asana, GitHub, and more.

Works with any MCP-compatible client: Claude, Cursor, Windsurf, Continue, etc.

Installation

npx stargate-mcp

Or install globally:

pnpm add -g stargate-mcp

Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "stargate": {
      "command": "npx",
      "args": ["stargate-mcp"],
      "env": {
        "ASANA_TOKEN": "your-asana-personal-access-token",
        "SLACK_TOKEN": "xoxp-your-slack-user-token",
        "GITHUB_TOKEN": "ghp_your-github-personal-access-token"
      }
    }
  }
}

Config file locations

Client	Path
Claude Code	~/.claude/settings.json or .mcp.json in project
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	.cursor/mcp.json in project

Environment Variables

Tools are conditionally loaded based on which tokens you provide:

Variable	Enables
ASANA_TOKEN	Asana task management tools
SLACK_TOKEN	Slack messaging tools
GITHUB_TOKEN	GitHub Projects V2 management tools

Available Tools

Asana

Get your token at: https://app.asana.com/0/developer-console

Tool	Description
asana_list_workspaces	List all accessible workspaces
asana_list_projects	List projects in a workspace
asana_list_sections	List sections (columns) in a project
asana_list_tasks	List tasks in a project or section
asana_get_task	Get task details including custom fields
asana_update_task	Update task name, notes, due date, completion
asana_update_custom_fields	Update custom fields (estimated/actual time)
asana_move_task	Move task to a different section
asana_add_comment	Add a comment to a task

Slack

Create a Slack App at: https://api.slack.com/apps

Install it to your workspace with a User Token (xoxp-) so messages appear as you. Required User Token scopes: channels:read, channels:history, groups:read, groups:history, chat:write.

Tool	Description
slack_list_channels	List Slack channels you can access
slack_send_message	Send a message to a channel
slack_read_messages	Read recent messages from a channel
slack_reply_to_thread	Reply to a message thread

GitHub Projects

Create a classic Personal Access Token at: https://github.com/settings/tokens

Required scopes: repo, project, read:org

Tool	Description
github_list_projects	List Projects V2 for a user or organization
github_get_project_fields	Get all fields (Status options = board columns, custom fields)
github_list_project_items	List items on a project board with optional status filter
github_get_project_item	Get full details of a single project item
github_update_project_item_field	Update any field value — move items between columns by setting Status
github_add_project_item	Add an existing issue/PR to a project, or create a draft issue
github_list_issue_comments	List comments on an issue
github_add_issue_comment	Add a comment to an issue
github_list_sub_issues	List sub-issues for a parent issue
github_update_issue	Update issue title, body, state, labels, assignees

Development

# Clone
git clone https://github.com/eggfriedrice24/stargate-mcp.git
cd stargate-mcp

# Install
pnpm install

# Build
pnpm build

# Run locally
ASANA_TOKEN=your-token pnpm start

License

MIT