GoldenGoose MCP Server

An MCP (Model Context Protocol) server for GoldenGoose - an AI-powered project management tool for developers. This server allows you to connect GoldenGoose's project management capabilities to any MCP-compatible client like Claude Desktop.

Installation

npm install -g goldengoose-mcp

Usage with Claude Desktop

Add this server to your Claude Desktop configuration:

macOS/Linux

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "goldengoose": {
      "command": "goldengoose-mcp"
    }
  }
}

Windows

Edit %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "goldengoose": {
      "command": "goldengoose-mcp"
    }
  }
}

After adding the configuration, restart Claude Desktop. You should see a 🔨 hammer icon indicating that MCP tools are available.

Available Tools

The server provides the following tools for managing your GoldenGoose projects:

• get_project_list - Get list of all active projects for the authenticated user
• view_roadmap - Get complete project roadmap with all features and their current status
• get_next_task - Retrieve the highest priority incomplete task from the project queue
• get_project_status - Get overall project progress summary with statistics
• get_feature_details - Get detailed information about a specific feature including its tasks and implementation plan
• update_task_progress - Update the status of a task (todo, in_progress, completed)
• add_feature - Create a new feature in the project
• get_implementation_plan - Retrieve the AI-generated implementation plan for a feature
• search_features - Search for features by keyword, status, or priority within a project
• add_task - Create a new task in the project, optionally associated with a feature

Example Usage in Claude

Once connected, you can ask Claude to help with your projects:

"Show me my current projects and their status"
"What's the next task I should work on for project XYZ?"
"Add a new feature for user authentication to my project"
"Show me the roadmap for my mobile app project"

Programmatic Usage

You can also use this package programmatically as an MCP client:

import { GoldenGooseMCPClient } from 'goldengoose-mcp';

const client = new GoldenGooseMCPClient({
  origin: 'https://goldengoose.dev'
});

async function example() {
  // Connect to the server
  const connected = await client.connect();
  if (!connected) {
    throw new Error('Failed to connect');
  }

  try {
    // List available tools
    const tools = await client.listTools();
    console.log('Available tools:', tools);

    // Call a specific tool
    const result = await client.callTool('get_project_list');
    console.log('Result:', result);
  } finally {
    // Always disconnect when done
    await client.disconnect();
  }
}

example().catch(console.error);

Development

To run the server locally:

git clone https://github.com/goldengoose/goldengoose-mcp.git
cd goldengoose-mcp
npm install
npm run build
npm start

Troubleshooting

If the server doesn't appear in Claude Desktop:

1. Check that the path in your configuration is correct
2. Restart Claude Desktop completely
3. Verify the server runs without errors: goldengoose-mcp
4. Check Claude's logs:
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log

About GoldenGoose

GoldenGoose is an AI-powered SWE Project Management Tool that keeps engineers and AI coding agents in sync with project progress. It allows users to:

• Easily add todos of things to fix or improve
• Systematically create and manage implementation plans
• Use intelligent reasoning with coding models
• Stay organized with project roadmaps and task management

Visit goldengoose.dev to learn more.

License

MIT

Contributing

Issues and pull requests are welcome on GitHub.