Back to OpenBuild
Back to OpenBuild

MCP Server Setup

Manage your OpenBuild projects directly from Claude Code using our MCP (Model Context Protocol) server.

What You Can Do

📋

Manage Projects

Create, update, and list your projects

📢

Post Updates

Share progress and announcements

🗺️

Update Roadmap

Add features and update their status

💬

Handle Discussions

Reply to threads and comments

Prerequisites

1

Generate an API Key

  1. 1.Go to Settings → API Keys
  2. 2.Click "Create API Key"
  3. 3.Give it a name (e.g., "My MacBook")
  4. 4.Copy the key - it won't be shown again!
Go to API Keys
2

Set Environment Variable

Add your API key to your shell profile:

export OPENBUILD_API_KEY="ob_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

Add this line to ~/.zshrc or ~/.bashrc, then restart your terminal.

3

Install the MCP Package

Install the OpenBuild MCP server globally:

npm install -g openbuild-mcp
4

Configure Claude Code

Add the MCP server to your Claude Code config:

Config file location:

  • macOS/Linux: ~/.claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "openbuild": {
      "command": "openbuild-mcp"
    }
  }
}

Restart Claude Code after saving the config.

Usage Examples

Once configured, just talk to Claude Code naturally:

  • →"List my OpenBuild projects"
  • →"Create a new project called 'My App'"
  • →"Post an update to my-project: We shipped dark mode!"
  • →"Show me the roadmap for my-project"
  • →"Move the auth feature to shipped"
  • →"Reply to the latest discussion thread"

Available Tools

Projects

list_projectsget_projectcreate_projectupdate_project

Updates

list_updatespost_updateedit_update

Features

list_featurescreate_featureupdate_feature_status

Discussions

list_threadsget_threadcreate_threadreply_to_thread

Notifications

list_notificationsmark_notifications_read

Troubleshooting

"API key is required"

Make sure OPENBUILD_API_KEY is set in your environment and you've restarted your terminal.

"Unauthorized"

Your API key may be invalid or revoked. Generate a new one in Settings.

MCP server not appearing

Check the config file path, ensure valid JSON, and restart Claude Code completely.

Ready to get started?

Create your first API key and start managing projects from Claude Code.

Create API Key