onlymcp

Your Claude Code skills, agents and memory, stored once in the cloud and available in every MCP client you use. This package ships two binaries: the stdio MCP server (onlymcp-mcp) and the CLI that sets up a client (onlymcp).

There is a second way in, and for most people it is the better one. The hosted server at https://only-mcp.com/api/mcp needs nothing installed, works from any machine, and is the only way to reach the tools of the MCP servers you connect to your account (GitHub, Google Drive, your own — see "The gateway" below):

claude mcp add --transport http onlymcp https://only-mcp.com/api/mcp \
  --header "Authorization: Bearer omk_…"

Create the token under "Connect" at only-mcp.com. The local server described below stays useful for one thing the address cannot do: writing skill stub files to disk, which Codex needs.

Requires a free account at only-mcp.com and Node.js 22 or newer.

Set up a client

npx onlymcp install --client claude   # or: codex, gemini
npx onlymcp login

install writes the MCP server entry into the client's own configuration file and merges into what is already there rather than replacing it:

| Client | File | | --- | --- | | Claude Code | ~/.claude.json | | Codex | ~/.codex/config.toml | | Gemini CLI | ~/.gemini/settings.json |

Any other MCP client works too. npx onlymcp install --print --client claude prints the JSON snippet to paste in by hand.

login connects the device over an OAuth device code (a code plus a QR in the terminal) and stores the token in the operating system keyring, never in a file.

Commands

| Command | What it does | | --- | --- | | onlymcp install --client <id> | Add OnlyMCP to a client's config | | onlymcp install --print --client <id> | Print the snippet, write nothing | | onlymcp login | Connect this device | | onlymcp status | Show whether this device is connected | | onlymcp sync | Rewrite the local stub files | | onlymcp logout | Remove the token and the local cache |

What the agent gets

This local server offers six tools: list_skills, get_skill, list_agents, get_agent_definition, memory_read and memory_write. They work in every MCP client. Clients with their own skill scanner additionally get stub files so the agent knows what exists without asking first. Claude Code can also spawn the agents as subagents; elsewhere they stay readable but not spawnable.

The gateway

The hosted endpoint offers a seventh tool, list_connections, and on top of that every tool of every MCP server you have connected to your account, prefixed with that connection's name (github__create_issue). Credentials for those servers are encrypted at rest and never handed to a client — the server calls them on your behalf. The local server in this package does not proxy them; use the hosted endpoint for that.

Environment

| Variable | Purpose | | --- | --- | | ONLYMCP_API_URL | Point at another instance (default https://only-mcp.com) | | ONLYMCP_STUB_DIRS | Colon-separated list of directories to write stubs into | | ONLYMCP_HOME | Move all local state, used by the tests | | ONLYMCP_TTL_SECONDS | Cache lifetime |

MIT licensed. Source at github.com/Francesco070/onlymcp.