WaymakerOS Help

Add https://mcp.waymakerone.com/mcp to Claude Desktop, Claude Code, or Cursor and your AI assistant can manage your tasks, documents, goals, sheets, deploy apps, and run your business through natural language.

Before You Start

You need a Waymaker account.

Don't have one? Sign up at commander.waymakerone.com — about 2 minutes.
Already signed up? Continue below.

Recommended: Connect via Cloud MCP

The fastest way. No installs. No terminal. About 5 minutes.

You create an access key in Commander, paste it into your AI tool's settings, and restart. That's it.

Step 1: Create your access key

Sign in at commander.waymakerone.com
In the left sidebar, click Settings → Access Keys
Click Create Access Key and give it a name like "My Claude Desktop"
Copy the key — it starts with wm_sk_ and is only shown once. Paste it somewhere safe (a sticky note, password manager, etc.) for the next step.

Your access key is your identity. It carries the same permissions you have when you sign in. Don't share it. Don't commit it to a public repo. You can revoke any key from Settings → Access Keys if it's lost.

Step 2: Add Waymaker to your AI tool

Pick the tool you use:

Claude Desktop (easiest — recommended for non-developers)

You don't need a code editor. Claude Desktop has a built-in "Edit Config" button that opens the settings file for you.

1. Open Claude Desktop

2. Open Claude Desktop Settings:

Mac: Click the Claude menu (top-left of your screen) → Settings…
Windows: Click the menu icon (top-left of the app window) → File → Settings

3. In Settings, click Developer in the left sidebar → click Edit Config

This opens a file called claude_desktop_config.json in your default text editor (TextEdit on Mac, Notepad on Windows).

4. Replace the contents of the file with this:

{
  "mcpServers": {
    "waymaker": {
      "type": "http",
      "url": "https://mcp.waymakerone.com/mcp",
      "headers": {
        "Authorization": "Bearer wm_sk_PASTE_YOUR_KEY_HERE"
      }
    }
  }
}

If the file already has other servers in it, just add the "waymaker": { ... } block inside the existing "mcpServers" section — don't delete what's already there.

5. Replace wm_sk_PASTE_YOUR_KEY_HERE with the access key you copied in Step 1. Keep the word Bearer and the space before your key.

6. Save the file (Cmd+S on Mac, Ctrl+S on Windows). Close the editor.

7. Quit Claude Desktop completely and reopen it. On Mac, closing the window is not enough — use Claude → Quit Claude (Cmd+Q). On Windows, right-click the system tray icon and select Quit.

Claude Code (for developers using the terminal)

In your project's root folder, create a file called .mcp.json:

{
  "mcpServers": {
    "waymaker": {
      "type": "http",
      "url": "https://mcp.waymakerone.com/mcp",
      "headers": {
        "Authorization": "Bearer wm_sk_PASTE_YOUR_KEY_HERE"
      }
    }
  }
}

Replace the placeholder with your key, add .mcp.json to your .gitignore so the key isn't committed, and restart Claude Code.

Important: Claude Code loads MCP servers from .mcp.json at the project root, not from .claude/settings.json.

Cursor

Edit .cursor/mcp.json in your project (or your global Cursor settings):

{
  "mcpServers": {
    "waymaker": {
      "type": "http",
      "url": "https://mcp.waymakerone.com/mcp",
      "headers": {
        "Authorization": "Bearer wm_sk_PASTE_YOUR_KEY_HERE"
      }
    }
  }
}

Replace the placeholder with your key, save, and restart Cursor.

Step 3: Test it works

Open a new chat in your AI tool and ask:

What Waymaker tools are available?

You should see 111 tools listed across Commander and Host (tasks, documents, goals, sheets, deploy apps, and more). If you do, you're connected.

Try one of these to confirm it's reading your real data:

"List my workspaces"
"What tasks are assigned to me?"
"Create a task called 'Test from Claude' on my main taskboard"

If nothing shows up, see Troubleshooting.

What Your AI Can Do

Once connected, your AI assistant has 111 tools across Waymaker:

Tasks — create, update, assign, list
Documents — read, write, organize in folders
Sheets — build spreadsheets with typed columns
Goals & OKRs — create objectives and track key results
Workspaces, Projects, Teams, Roles — full org management
Frameworks — apply Waymaker leadership frameworks like the 7 Questions
Connections — webhooks, MCP servers, signals
Host Apps & Ambassadors — deploy custom apps and serverless functions
Custom Domains — set up domains for hosted apps
Search — across your entire workspace

Full list: Available MCP Tools

Alternative: Waymaker CLI (for developers)

If you want to deploy apps from the terminal (waymaker host apps deploy), sync markdown files between your IDE and Commander, or use a terminal kanban view, install the CLI instead:

npm install -g @waymakeros/cli
waymaker auth login
waymaker init

Full guide: CLI Installation

Two Ways to Connect — Comparison

Method	Best For	Install Required?
Cloud MCP	Claude Desktop, Claude Code, Cursor users	No — just paste an access key into config
Waymaker CLI	Developers — deploy apps, sync files, terminal commands	Yes — `npm install -g @waymakeros/cli`

Most users want Cloud MCP. The CLI is for developers who specifically need sync or terminal commands.

Partners Managing Multiple Clients

Each access key is scoped to one organization. If you manage multiple clients, you need a separate access key per client to avoid putting work in the wrong org.

See Partner Setup — Organization Isolation for the recommended pattern.

More Detail

AI Agent Setup Guide — full provider configs, all 111 tools, troubleshooting
CLI Installation — terminal install, OAuth login, project setup
Project Organization — prepare your docs before syncing
Command Reference — every CLI command

Need help? Contact support at help.waymakerone.com

Connect Claude, Cursor & AI Tools