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:- Collect pull requests, issues, notifications, and relevant Slack activity.
- Produce a prioritized report with links and a recommended first task.
- Help you complete that task or start a separate agent to work on another task.
- 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.

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
- Open GitHub Developer Settings.
- Select Fine-grained tokens and choose Generate new token.
- Give the token a name, select Only select repositories when possible, and set an expiration date.
- Grant the minimum permissions for the work you want the agent to do:
- Generate the token and copy it. GitHub shows it only once.

Add the GitHub MCP server
Use the backend where this conversation will run. The MCP server and its saved secret belong to that backend.- In Agent Canvas, confirm the correct backend in the backend switcher.
- Open Customize in the left navigation.
- Open MCP Servers.
- Select GitHub from the MCP library.
- Paste the token into the token field.
- Leave the option to create a secret enabled, then save the server.
- Wait for the server card to report a healthy connection.
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
- Open the Slack API dashboard and select Create New App → From scratch.
- Choose the workspace where the app will read messages.
- In OAuth & Permissions, add these bot scopes:
- Select Install to Workspace, approve the permissions, and copy the Bot User OAuth Token.
- Invite the bot to each channel it should monitor. The bot cannot read channels it has not joined.
- Find your workspace ID from your Slack workspace URL or Slack’s workspace-ID guide.

Add the Slack MCP server
The same Customize → MCP Servers screen is used for Slack.- In Agent Canvas, open Customize → MCP Servers.
- Select Slack from the MCP library.
- Paste the bot token and enter the workspace ID.
- Keep secret creation enabled and save the server.
- 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:
Step 4: Read the prioritized report
Ask for a report in this format if the first response is not organized clearly:Step 5: Work through one task at a time
When the agent recommends a task:- Ask for links if the report does not include them:
Give me the links for that task. - Tell the agent whether you want investigation, implementation, or only a summary.
- Set the safety boundary before it changes anything. For example:
- After reviewing the result, ask it to implement the approved change, run the relevant checks, and report what changed.
- When the task is complete, ask:
Step 6: Dispatch parallel work
Use a separate agent only for work that is independent of the task you are handling. For example:- 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
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
- Daily workflow video — optional video walkthrough
- Agent Canvas overview
- Agent Canvas first-time setup
- MCP server settings
- Agent Canvas configuration

