SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Oboard MCP with Hermes

Connect Hermes 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.

Get started for freeGet a demo
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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Oboard account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Oboard with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Oboard with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Oboard

Ask your agent to connect to Oboard, or simply request any Oboard-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Oboard connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Oboard or request any Oboard-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Oboard connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

FRAMEWORKS

How to build Oboard MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Oboard MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Oboard MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Oboard MCP with Atomic Agent

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. Hermes 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