How to integrate Oboard MCP with Atomic Agent

Connect Atomic Agent to Oboard MCP. List overdue oboard objectives by team, update progress for quarterly oboard goals, and more using natural language, with authentication handled for you.

Oboard logoOboard
Api Key

Oboard is an objectives and key results platform for managing goals, teams, and workspaces. It gives organizations a clear view of progress and priorities in one place.

32 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Oboard.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Oboard account. See the Atomic Agent documentation for installation instructions.

Also integrate Oboard with

How Atomic Agent connects to Oboard

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Oboard to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Oboard. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Oboard account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Oboard MCP server, and what's possible with it?

The Oboard MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Oboard account. It provides structured and secure access to objectives, key results, progress updates, check-ins, teams, groups, workspaces, and planning data, so your agent can review goals, update progress, manage team access, organize workspaces, and maintain strategic planning information on your behalf.

  • Goal and key result management: Have your agent create, retrieve, update, replace, and delete Oboard objectives, key results, and Jira-linked elements.
  • Progress and check-in tracking: Let the agent record check-ins, update progress values, review progress history, search check-ins, and add or review comments for goals.
  • Workspace and planning oversight: Direct your agent to list accessible workspaces, review planning intervals, find child elements, and inspect labels, confidence levels, and custom fields.
  • Team and group administration: Instruct your agent to search users, create or update groups, add or remove members, and update workspace roles.
  • Strategic planning maintenance: Have your agent list, create, and update strategic components, then adjust the rules and ordering used to organize Oboard elements.

Use Oboard from Atomic Agent

With your account connected, ask Atomic Agent to work with Oboard in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Oboard action and event your agent gets out of the box.

Add Users to Group

Add one or more existing Oboard users to a group.

Create Check-In

Create a check-in that records a progress value, status, or comment for an Oboard element.

Create Element

Create an Oboard objective, key result, or Jira-linked element in a workspace and interval.

Create Element Value

Create a dated numeric value for an Oboard element.

Create Group

Create an Oboard group in selected workspaces or all workspaces.

Create Strategic Component

Create an Oboard strategic component with its ordering, type, workspace placement, and element rules.

Delete Element

Delete one Oboard element and optionally its nested objectives.

Delete Element Value

Delete one dated value record from an Oboard element.

Delete Group

Delete one Oboard group, optionally deleting its users too.

Get Element

Retrieve one current Oboard element by its numeric ID.

List Child Elements

List and filter current child elements below a parent, including manual-weight metadata, one page at a time.

List Confidence Levels

List Oboard confidence-level IDs and names, optionally restricted to accessible workspaces.

List Custom Fields

List Oboard custom-field definitions across accessible workspaces.

List Element Comments

Retrieve comments for one or more Oboard elements.

List Element Progress History

Retrieve dated progress values for multiple Oboard elements, one page at a time.

List Elements

List and filter current Oboard objectives, key results, and Jira-linked elements, one page at a time.

List Element Values

List all dated values recorded for one Oboard element.

List Groups

List current Oboard groups and their workspace, permission, synchronization, and user-count metadata.

List Intervals

List planning intervals, dates, and open or backlog state for one workspace.

List Labels

List current Oboard labels, optionally filtered by name.

List Strategic Components

List current Oboard strategic components, optionally filtered by component or workspace IDs.

List Users

Search current Oboard users across workspaces, roles, and groups, one page at a time.

List Workspaces

List workspaces accessible to the connected Oboard API token.

Remove Users from Group

Remove one or more existing Oboard users from a group.

Replace Element

Update an existing Oboard element through its broad PUT operation, which can set editable metadata, hierarchy, progress, assignments, integer manual-date states, and privacy in one call.

Replace Group

Replace the settings, workspace links, platform links, and membership list of an existing Oboard group.

Search Check-Ins

Search check-ins for selected elements and optionally include element or comment details, one page at a time.

Update Check-In

Update an existing Oboard check-in's progress value, status, or comment.

Update Element Properties

Update one or more named properties on an existing Oboard element without replacing the complete element.

Update Element Value

Update the numeric value of one Oboard element-value record.

Update Strategic Component

Update an existing Oboard strategic component's identity, ordering, and element rules.

Update User Roles

Bulk update users' workspace roles.

FAQ

Frequently asked questions

With a standalone Oboard MCP server, the agents and LLMs can only access a fixed set of Oboard tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Oboard and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Oboard tools.

Yes, absolutely. You can configure which Oboard scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Oboard data and credentials are handled as safely as possible.

Start with Oboard.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Oboard tool your agent needs.Free to start.

Start building