[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_126":127},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":-5,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98},"apiUrl","https://odel.app/api","creator","withoneai","moduleId","mcp","@withoneai/mcp","displayName","One","tagline","Search, document and execute authenticated API calls across 700+ apps via one MCP server","iconKey","https://www.withone.ai/icons/apple-touch-icon.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.withone.ai/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1786594776000,"updatedAt",1788755364000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.withone%2Fmcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",10,"upstreamUpdatedAt",1787332330000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1788063679000,"githubRepoUrl","https://github.com/withoneai/mcp","githubRepoFullName","withoneai/mcp","releaseId","ext-withoneai-mcp","version","1.2.4","descriptionMarkdown"," $\"One$ \n\n

One MCP Server

\n\n

\n Website\n · \n Docs\n · \n Dashboard\n · \n Changelog\n · \n X\n · \n LinkedIn\n

\n\n

\n $\"npm$ \n

\n\nConnect your AI agents to 700+ apps through a single [MCP](https://modelcontextprotocol.io) server. Search for actions, read documentation, and execute API calls across platforms, without having to manage OAuth tokens or API keys.\n\n```bash\nnpm install -g @withone/cli\none init\n```\n\nThat's it. The [One CLI](https://www.npmjs.com/package/@withone/cli) will prompt you for your API key (get one from the [One dashboard](https://app.withone.ai/settings/api-keys)) and configure the MCP server for your environment: Claude Desktop, Cursor, Claude Code, Windsurf, or any MCP-compatible agent.\n\n## Capabilities\n\n- **700+ platforms.** Gmail, Slack, Shopify, HubSpot, Stripe, Linear, QuickBooks, and [more](https://app.withone.ai/tools).\n- **Natural language execution.** \"read my last gmail email\", \"send a message to #general on Slack\"\n- **Code generation.** \"build a form to send emails using Gmail\", \"create a dashboard that lists my Linear projects\"\n- **No tool bloat.** Only 4 tools exposed regardless of how many platforms or actions you connect. Actions are search-based, so your agent's context window stays clean.\n- **Fine-grained access control.** Restrict which actions, connections, and permission levels (read, write, admin) your agent has access to.\n- **Secure by default.** All requests proxied through One, secrets automatically redacted, no platform API keys to manage.\n\n## Examples\n\n**Execute actions directly:**\n> \"Get my last 5 emails from Gmail\"\n\n> \"Send a Slack message to #general: 'Meeting in 10 minutes'\"\n\n> \"Get all products from my Shopify store\"\n\n**Generate integration code:**\n> \"Create a React form component that sends emails using Gmail\"\n\n> \"Build a dashboard that displays Linear users and their assigned projects with filtering\"\n\n> \"Create a paginatable table that fetches and displays QuickBooks invoices with search and sort\"\n\n## Tools\n\nThe server exposes four MCP tools:\n\n| Tool | Description |\n|------|-------------|\n| `list_one_integrations` | List available platforms and active connections, each with the `access` it confers (full, methods, or specific actions) |\n| `search_one_platform_actions` | Search for actions on a specific platform |\n| `get_one_action_knowledge` | Get detailed documentation for an action |\n| `execute_one_action` | Execute an API action on a connected platform |\n\n## Remote MCP Server\n\nPrefer not to run anything locally? One hosts a remote MCP server at **`https://mcp.withone.ai/mcp`**. Point any MCP client that supports remote (HTTP) servers at that URL and authenticate with One via OAuth. There's no `npm install` and no `ONE_SECRET` to manage. You approve access in One's consent screen, where you can scope exactly which connections, actions, and permission levels the agent gets. Those choices are surfaced back to the agent through each connection's `access` field, so it knows what it can run without searching.\n\nAdd it to your client's MCP configuration. The endpoint speaks the Streamable HTTP transport:\n\n```json\n{\n \"mcpServers\": {\n \"one\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.withone.ai/mcp\"\n }\n }\n}\n```\n\nSome clients omit `type` and take the URL alone; UI-based clients (custom connectors) just need the URL itself. On first connect, your client opens a browser to authenticate and authorize with One. After that, the same four tools are available.\n\nOne-click install:\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_One-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=one&config=%7B%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A%2F%2Fmcp.withone.ai%2Fmcp%22%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_One-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=one&config=%7B%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A%2F%2Fmcp.withone.ai%2Fmcp%22%7D)\n[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_One-000000?style=flat-square)](https://cursor.com/en/install-mcp?name=one&config=eyJ1cmwiOiAiaHR0cHM6Ly9tY3Aud2l0aG9uZS5haS9tY3AifQ==)\n[![Open in Windsurf](https://img.shields.io/badge/Windsurf-Open_One-09B6A2?style=flat-square)](windsurf://windsurf-mcp-registry?serverName=ai.withone/mcp)\n\nThe Windsurf link opens One's page in the editor's MCP marketplace, which is served from the official MCP registry where One is published as `ai.withone/mcp`. Windsurf handles the OAuth sign-in itself once you install from that page.\n\n## Manual Installation\n\nIf you prefer to configure the server manually instead of using `one init`, install the package directly:\n\n```bash\nnpm install @withone/mcp\n```\n\nThen set the required environment variable:\n\n```bash\nONE_SECRET=your-one-secret-key\n```\n\n### Identity Scoping\n\nScope connections to a specific identity (e.g., a user, team, or organization):\n\n```bash\nONE_IDENTITY=user_123\nONE_IDENTITY_TYPE=user\n```\n\n| Variable | Description | Values |\n|----------|-------------|--------|\n| `ONE_IDENTITY` | The identifier for the entity (e.g., user ID, team ID) | Any string |\n| `ONE_IDENTITY_TYPE` | The type of identity | `user`, `team`, `organization`, `project` |\n\nWhen set, the MCP server will only return connections associated with the specified identity. This is useful for multi-tenant applications where you want to scope integrations to specific users or entities.\n\n### Access Control\n\nFine-tune what the MCP server can see and do:\n\n```bash\nONE_PERMISSIONS=read\nONE_CONNECTION_KEYS=conn_key_1,conn_key_2\nONE_ACTION_IDS=action_id_1,action_id_2\nONE_KNOWLEDGE_AGENT=true\n```\n\n| Variable | Type | Default | Description |\n|---|---|---|---|\n| `ONE_PERMISSIONS` | `read` \\| `write` \\| `admin` | `admin` | Filter actions by HTTP method. `read` = GET only, `write` = GET/POST/PUT/PATCH, `admin` = all methods |\n| `ONE_CONNECTION_KEYS` | `*` or comma-separated keys | `*` | Restrict visible connections and platforms to specific connection keys |\n| `ONE_ACTION_IDS` | `*` or comma-separated IDs | `*` | Restrict visible and executable actions to specific action IDs |\n| `ONE_KNOWLEDGE_AGENT` | `true` \\| `false` | `false` | Remove the `execute_one_action` tool entirely, forcing knowledge-only mode. `get_one_action_knowledge` responses additionally include an Integration Code Guide (passthrough URL, `x-one-*` headers, `ONE_SECRET` / `ONE_{PLATFORM}_CONNECTION_KEY` env vars, backend-only placement) for writing application code |\n\nAll defaults preserve current behavior. If no access control env vars are set, the server starts with full access and all tools available.\n\nWhatever you configure here is surfaced back to the agent: `list_one_integrations` stamps each connection with an `access` field so the agent knows up front what it can run there, without spending a turn searching. It is one of:\n\n| `access` | When |\n|---|---|\n| `{ \"policy\": \"full\" }` | No action allowlist and `ONE_PERMISSIONS=admin` — every action is runnable. |\n| `{ \"policy\": \"methods\", \"methods\": [\"GET\", ...] }` | No action allowlist, but `ONE_PERMISSIONS` is `read`/`write` — only these HTTP methods are runnable. |\n| `{ \"policy\": \"actions\", \"actions\": [{ \"actionId\", \"title\", \"method\" }] }` | `ONE_ACTION_IDS` is set — exactly these actions (the ones on that connection's platform) are runnable, so no search is needed. |\n\n## Manual Configuration\n\nIf you used `one init`, the configuration below is already done for you. These examples are for reference or manual setups.\n\n### Standalone\n\n```bash\nnpx @withone/mcp\n```\n\n### Claude Desktop / Cursor\n\nAdd the following to your MCP config:\n\n- **Claude Desktop:** MacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json` · Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n- **Cursor:** Open the Cursor menu and select \"MCP Settings\"\n\n```json\n{\n \"mcpServers\": {\n \"one\": {\n \"command\": \"npx\",\n \"args\": [\"@withone/mcp\"],\n \"env\": {\n \"ONE_SECRET\": \"your-one-secret-key\"\n }\n }\n }\n}\n```\n\n### Docker\n\n```bash\ndocker build -t one-mcp-server .\ndocker run -e ONE_SECRET=your_one_secret_key one-mcp-server\n```\n\nAll environment variables listed above can be passed as `-e` flags.\n\n## Security\n\nAll requests to third-party platforms are authenticated and proxied through One's API. The MCP server never handles OAuth tokens or platform API keys directly. The `ONE_SECRET` key is the sole credential required, and it is automatically redacted from all response payloads returned to clients. Sensitive headers are stripped from logged and returned request configurations.\n\n## License\n\nMIT\n\n## Support\n\nFor support, please contact support@withone.ai or visit https://withone.ai\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_107":108,"_109":110,"_111":112,"_113":114,"_115":116,"_117":118},"requiredSecrets",[],"tags",[101,102,103,104,105,106],"assets",[],"stats",{"_99":86,"_100":86},"ratingAvg","reviewCount","agents","ai-agents","apps","gemini-cli-extension","integrations","one","topics",[101,102,103,104,105,21,124,125,106],"license","MIT","language","TypeScript","registryName","ai.withone/mcp","homepage","https://withone.ai","packages",[119],{"_120":121,"_122":123,"_76":77},"registryType","npm","identifier","@withone/mcp","mcp-server","model-context-protocol","ENV",{"_128":129,"_130":131,"_132":133},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]