# One

One gives AI agents a single MCP connection to connected apps, letting them find documented API actions and run them when a task needs it.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: withoneai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/withoneai/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/one

## What it does

One connects an agent to actions in Gmail, Slack, Shopify, HubSpot, Stripe, Linear, QuickBooks, and other apps. It can identify the operations a task needs, return their documentation, and call an action on a connected platform. The server exposes three tools: `list_one_integrations`, `find_one_actions`, and `execute_one_action`.

Access can be scoped by connection, action, and permission level: read, write, or admin. Requests are proxied through One, with secrets redacted automatically. You can use the remote endpoint at `https://mcp.withone.ai/mcp` with OAuth, or run the local `@withone/mcp` package. The local setup through `one init` asks for an API key.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.withone.ai/mcp`
- Environment variables: `ONE_SECRET`, `ONE_PERMISSIONS`, `ONE_CONNECTION_KEYS`, `ONE_ACTION_IDS`, `ONE_KNOWLEDGE_AGENT`, `ONE_IDENTITY`, `ONE_IDENTITY_TYPE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.withone.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ONE_SECRET=<ONE_SECRET> --env ONE_PERMISSIONS=<ONE_PERMISSIONS> --env ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> --env ONE_ACTION_IDS=<ONE_ACTION_IDS> --env ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> --transport stdio one -- npx -y @withone/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add one --url https://mcp.withone.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add one --env ONE_SECRET=<ONE_SECRET> --env ONE_PERMISSIONS=<ONE_PERMISSIONS> --env ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> --env ONE_ACTION_IDS=<ONE_ACTION_IDS> --env ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> -- npx -y @withone/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "one": {
            "url": "https://mcp.withone.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "one": {
            "command": "npx",
            "args": [
                "-y",
                "@withone/mcp"
            ],
            "env": {
                "ONE_SECRET": "<ONE_SECRET>",
                "ONE_PERMISSIONS": "<ONE_PERMISSIONS>",
                "ONE_CONNECTION_KEYS": "<ONE_CONNECTION_KEYS>",
                "ONE_ACTION_IDS": "<ONE_ACTION_IDS>",
                "ONE_KNOWLEDGE_AGENT": "<ONE_KNOWLEDGE_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "one": {
            "type": "http",
            "url": "https://mcp.withone.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "one": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@withone/mcp"
            ],
            "env": {
                "ONE_SECRET": "<ONE_SECRET>",
                "ONE_PERMISSIONS": "<ONE_PERMISSIONS>",
                "ONE_CONNECTION_KEYS": "<ONE_CONNECTION_KEYS>",
                "ONE_ACTION_IDS": "<ONE_ACTION_IDS>",
                "ONE_KNOWLEDGE_AGENT": "<ONE_KNOWLEDGE_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http one https://mcp.withone.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ONE_SECRET=<ONE_SECRET> -e ONE_PERMISSIONS=<ONE_PERMISSIONS> -e ONE_CONNECTION_KEYS=<ONE_CONNECTION_KEYS> -e ONE_ACTION_IDS=<ONE_ACTION_IDS> -e ONE_KNOWLEDGE_AGENT=<ONE_KNOWLEDGE_AGENT> one npx -y @withone/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- find the API action needed for a task
- inspect action documentation before execution
- send a Slack message from an agent
- retrieve data from Gmail, Shopify, or Linear
- limit agent access by permission level

## Example prompts
- Find and run the action that sends a message to a Slack channel.
- Fetch my latest Gmail messages and show their senders and subjects.
- Build a searchable, sortable table of QuickBooks invoices.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md