One MCP Server

by withoneaiai.withone/mcpv2.0.0

Search, document and execute authenticated API calls across apps such as Gmail, Slack, Stripe, Notion and GitHub through a few tools with constant context size.

11Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install One MCP server

claude mcp add withone -e ONE_SECRET='<one-secret>' -- npx -y @withone/mcp

{
  "mcpServers": {
    "withone": {
      "command": "npx",
      "args": [
        "-y",
        "@withone/mcp"
      ],
      "env": {
        "ONE_SECRET": "<one-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "withone": {
      "command": "npx",
      "args": [
        "-y",
        "@withone/mcp"
      ],
      "env": {
        "ONE_SECRET": "<one-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "withone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@withone/mcp"
      ],
      "env": {
        "ONE_SECRET": "<one-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "withone": {
      "command": "npx",
      "args": [
        "-y",
        "@withone/mcp"
      ],
      "env": {
        "ONE_SECRET": "<one-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ONE_SECRET	yes	yes	One API key from https://app.withone.ai/settings/api-keys
ONE_PERMISSIONS	—	—	Restrict actions by HTTP method: read (GET), write (GET/POST/PUT/PATCH) or admin (all)
ONE_CONNECTION_KEYS	—	—	Comma-separated connection keys the agent may see, or * for all
ONE_ACTION_IDS	—	—	Comma-separated action IDs the agent may see and run, or * for all
ONE_KNOWLEDGE_AGENT	—	—	Set true to drop execute_one_action and run in knowledge-only mode
ONE_IDENTITY	—	—	Scope connections to a single user, team, organization or project identifier
ONE_IDENTITY_TYPE	—	—	Type of ONE_IDENTITY: user, team, organization or project

Remote endpoints

streamable-httphttps://mcp.withone.ai/mcp

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 9d ago · GitHub
Latest release
2026-09-30 · 9d ago · GitHub · 2.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 9d ago · official registry · v2.0.0

FAQ

›How do I install the One MCP server in Claude Code?

Run: claude mcp add withone -e ONE_SECRET='<one-secret>' -- npx -y @withone/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does One require an API key?

Yes. It expects ONE_SECRET, of which 1 is a secret.

›Can I use One as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is One in the official MCP registry?

Yes, as ai.withone/mcp.