Connect Soon to Claude Code

This adds Soon to Claude Code, the command line tool.

Before you start

• A Soon account you can sign in to.
• Claude Code installed and signed in.

You connect as yourself, so the assistant sees exactly what you see in Soon and nothing more. Your permissions carry over: if you cannot edit a board in Soon, the assistant cannot edit it either.

Steps

1. In your terminal, run:

claude mcp add --transport http soon https://mcp.soon.works/mcp

1. Start Claude Code by running claude.
2. The first time you use a Soon command, a browser window opens with the Soon sign-in page. Sign in with your normal Soon account.
3. Review the request and select Approve.

Keep the terminal open while you complete the sign-in in your browser.

Or install the plugin

The plugin adds the same connection plus a few Soon specific shortcuts. In Claude Code, run:

/plugin marketplace add SoonHQ/soon-claude-plugin

Then:

/plugin install soon@soon

Check that it worked

Ask the assistant:

What is on my schedule this week?

You should get your own shifts back. If you are a planner, try "Who is working on Friday?" as well. If the assistant says it has no Soon tools available, the connection did not complete. See the troubleshooting section below.

What you can ask for

Once connected, you can ask in plain language. For example:

• "What am I working this week?"
• "Who is available to cover Friday evening?"
• "Request leave for the 12th to the 16th."
• "Move Jackson off Saturday and put Ada on instead."

Soon marks every action that changes the schedule as destructive, so your assistant asks before running one. That prompt comes from the assistant rather than from Soon, so only connect assistants you trust.

Turn it off

Run:

claude mcp remove soon

Troubleshooting

"MCP server soon already exists in user config"

You already have an entry with that name. Remove it first, then add it again:

claude mcp remove soon

The browser opens the wrong sign-in page

Claude Code remembers the sign-in per connection name. If you previously connected the name "soon" to a test address, remove it and add it again. Removing and re-adding under the same name clears the old sign-in.

The browser says the page cannot be reached

The sign-in returns to a short lived address on your own machine. If the terminal was closed, or you clicked a link from an earlier attempt, there is nothing listening and the page fails. Start again, leave the terminal running, and use only the link from that attempt.

The assistant says it cannot see a board

The connection carries your own Soon permissions. If a board is missing, check in Soon that you have access to it. Ask your team owner to add you if not.

Still stuck

Contact us at support@soon.works and tell us which app you are connecting from. Include any error message you see.