85 lines
2.7 KiB
Plaintext
85 lines
2.7 KiB
Plaintext
---
|
|
title: "OpenWork MCP for OpenCode"
|
|
sidebarTitle: "OpenCode"
|
|
description: "OpenCode MCP setup for OpenWork Connect, OpenWork's hosted MCP server for Gmail, Calendar, Drive, shared connections, skills, and Cloud resources."
|
|
---
|
|
|
|
The OpenWork MCP server ([OpenWork Connect](/cloud/run-in-the-cloud/cloud-mcp))
|
|
enables OpenCode to use the OpenWork capabilities your organization has made
|
|
available to you: Gmail read/search, Calendar list/create, Drive search/read,
|
|
Gmail draft creation, shared MCP connections such as Notion, Linear, Slack,
|
|
Stripe, Exa, and Context7, shared skills, and OpenWork Cloud resources like
|
|
skills, plugins, Collections, workers, members, roles, teams, and LLM
|
|
providers. The server exposes only `search_capabilities` and
|
|
`execute_capability`, so OpenCode searches what you can access and runs exact
|
|
capability names instead of loading hundreds of tool definitions into context.
|
|
|
|
## Server URL
|
|
|
|
```text
|
|
https://api.openworklabs.com/mcp/agent
|
|
```
|
|
|
|
OAuth sign-in uses your OpenWork account, and the organization you pick is
|
|
pinned into the token. If you do not have an account, create a
|
|
[free OpenWork account](https://app.openworklabs.com?mode=sign-up).
|
|
|
|
## Setup
|
|
|
|
1. Add this MCP entry to your `opencode.json` file:
|
|
|
|
```json
|
|
{
|
|
"mcp": {
|
|
"openwork": {
|
|
"type": "remote",
|
|
"enabled": true,
|
|
"url": "https://api.openworklabs.com/mcp/agent",
|
|
"oauth": {}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
2. Authenticate the server:
|
|
|
|
```sh
|
|
opencode mcp auth openwork
|
|
```
|
|
|
|
3. Finish the browser sign-in, then choose the organization OpenCode should use.
|
|
|
|
If OpenCode runs on a remote machine or SSH host, follow
|
|
[Connect OpenWork MCP from a remote machine](/cloud/run-in-the-cloud/connect-openwork-mcp-remote-machine).
|
|
|
|
## Switch organizations
|
|
|
|
Log out, then authenticate again and pick the organization you want in the
|
|
browser:
|
|
|
|
```sh
|
|
opencode mcp logout openwork
|
|
opencode mcp auth openwork
|
|
```
|
|
|
|
<Note>
|
|
OpenCode is the verified OpenWork Connect client. Native remote MCP OAuth passed
|
|
end-to-end implementation testing.
|
|
</Note>
|
|
|
|
## What you can ask
|
|
|
|
- "Which OpenWork organization am I connected to?"
|
|
- "Add omar@example.com to my organization."
|
|
- "Create a skill that writes weekly status reports and share it with my whole organization."
|
|
- "Find the Q3 launch page in Notion and summarize it."
|
|
|
|
## What's next
|
|
|
|
- Read the [hub overview](/cloud/run-in-the-cloud/cloud-mcp) for OAuth, token,
|
|
server exposure, and troubleshooting details.
|
|
- Publish Notion, Linear, Slack, and other shared tools with
|
|
[shared MCP connections](/cloud/share-with-your-team/shared-mcp-connections).
|
|
- Connect from an SSH host with
|
|
[OpenWork MCP on a remote machine](/cloud/run-in-the-cloud/connect-openwork-mcp-remote-machine).
|