Skip to main content
This guide shows how to use the OpenHands Agent Canvas as a daily development work queue. The agent gathers work from GitHub and Slack, organizes it by urgency, gives you one task at a time, and can dispatch separate agents for work that can happen in parallel. The video above demonstrates the same workflow for readers who prefer a video walkthrough. You do not need to watch it to follow this guide.

What you will build

At the end of this guide, one Agent Canvas conversation will:
  1. Collect pull requests, issues, notifications, and relevant Slack activity.
  2. Produce a prioritized report with links and a recommended first task.
  3. Help you complete that task or start a separate agent to work on another task.
  4. Continue with the next task when you are ready.

Prerequisites

  • Install and start Agent Canvas.
  • Complete first-time setup, including an OpenHands agent profile, a connected backend, and an LLM.
  • A GitHub account with access to the repositories you want to review.
  • A Slack workspace and permission to create or install a Slack app.
Agent Canvas MCP library showing built-in GitHub and Slack integrations The MCP library lists built-in integrations, including GitHub and Slack. Choose the HTTP Slack integration shown here when following this guide. The workflow can use other MCP integrations, such as Linear or Jira, but the examples below use GitHub and Slack.

Step 1: Connect GitHub

The agent needs GitHub access to find assigned issues, pull requests that need your attention, review requests, notifications, and CI results.

Create a GitHub token

  1. Open GitHub Developer Settings.
  2. Select Fine-grained tokens and choose Generate new token.
  3. Give the token a name, select Only select repositories when possible, and set an expiration date.
  4. Grant the minimum permissions for the work you want the agent to do:
  1. Generate the token and copy it. GitHub shows it only once.
Agent Canvas GitHub MCP server setup dialog The GitHub server dialog shows where to enter the server token and save it as a backend secret.

Add the GitHub MCP server

Use the backend where this conversation will run. The MCP server and its saved secret belong to that backend.
  1. In Agent Canvas, confirm the correct backend in the backend switcher.
  2. Open Customize in the left navigation.
  3. Open MCP Servers.
  4. Select GitHub from the MCP library.
  5. Paste the token into the token field.
  6. Leave the option to create a secret enabled, then save the server.
  7. Wait for the server card to report a healthy connection.
See MCP server settings for general configuration and troubleshooting details. Do not paste tokens into the conversation itself.

Step 2: Connect Slack

Slack access lets the agent find mentions, threads, and messages that need your response. The bot can read only channels it can access.

Create and install a Slack app

  1. Open the Slack API dashboard and select Create New AppFrom scratch.
  2. Choose the workspace where the app will read messages.
  3. In OAuth & Permissions, add these bot scopes:
  1. Select Install to Workspace, approve the permissions, and copy the Bot User OAuth Token.
  2. Invite the bot to each channel it should monitor. The bot cannot read channels it has not joined.
  3. Find your workspace ID from your Slack workspace URL or Slack’s workspace-ID guide.
Agent Canvas Slack MCP server setup dialog The built-in Slack integration dialog shows the workspace ID and bot-token fields, along with the option to save each value as a secret.

Add the Slack MCP server

The same Customize → MCP Servers screen is used for Slack.
  1. In Agent Canvas, open CustomizeMCP Servers.
  2. Select Slack from the MCP library.
  3. Paste the bot token and enter the workspace ID.
  4. Keep secret creation enabled and save the server.
  5. Wait for a healthy connection, then verify that the bot can access the channels you want to search.

Step 3: Start the daily workflow conversation

Create a new conversation in Agent Canvas and send this prompt: Agent Canvas new conversation with the daily workflow prompt
If you use Linear, Jira, or another connected service, add it explicitly to the prompt. For example:
The agent may ask clarifying questions, such as which repositories or Slack channels to include. Answer those questions before asking it to produce the final report.

Step 4: Read the prioritized report

Ask for a report in this format if the first response is not organized clearly:
A useful report looks like this:
The report is a starting point, not a guarantee that every source contains actionable work. Ask the agent to search a specific repository, channel, or date range when an important item is missing.

Step 5: Work through one task at a time

When the agent recommends a task:
  1. Ask for links if the report does not include them: Give me the links for that task.
  2. Tell the agent whether you want investigation, implementation, or only a summary.
  3. Set the safety boundary before it changes anything. For example:
  1. After reviewing the result, ask it to implement the approved change, run the relevant checks, and report what changed.
  2. When the task is complete, ask:
The agent can inspect and edit files in its configured workspace, but its ability to push code, update GitHub, or post to Slack depends on the permissions granted to the MCP servers and the confirmation policy you use.

Step 6: Dispatch parallel work

Use a separate agent only for work that is independent of the task you are handling. For example:
Before dispatching, specify:
  • Which repositories, pull requests, or issues it may access
  • Whether it may edit files
  • Which tests it should run
  • Whether it may push branches or post comments
  • What it should return when finished
Keep related changes in separate workspaces or branches to avoid overwriting your active work. Review a subagent’s summary and diff before asking it to push or make external changes. You can continue the original conversation while the separate agent runs, then inspect its conversation from the Agent Canvas conversation list.

Troubleshooting

  • The agent cannot find GitHub work: confirm the GitHub MCP server is healthy, the token includes the required repositories, and the token has not expired.
  • Slack results are empty: confirm the bot is installed in the workspace and invited to each channel you want to search.
  • The agent reports no tools: start a new conversation after adding or changing an MCP server; MCP configuration is loaded when a conversation starts.
  • The report is too broad: name the repositories, Slack channels, date range, or task categories to include.
  • The agent tries to act too early: state that it must ask for approval before editing files, pushing, or posting messages.

Reference