Back to documentation

RoryPlans Connector for Claude

Connect Claude to RoryPlans through a remote MCP server so Claude can create plans, update plans, list plan work, and pull assigned agent tasks from your RoryPlans workspace.

What it is

The RoryPlans Connector for Claude is a remote Model Context Protocol (MCP) connection for Claude app, Claude Code, and Claude Cowork workflows. The MCP server is available at:

https://www.roryplans.ai/api/mcp

Claude custom connectors use OAuth access tokens. Other MCP clients can also connect with RoryPlans API tokens when they support bearer-token configuration.

What you can do

The connector exposes plan-management tools and an agent dispatch loop for Claude or other connected agents.

Plan tools

  • create_plan

    Create a new plan from a natural-language prompt.

  • modify_plan

    Modify a plan by adding goals or tasks, updating fields, rescheduling, or deleting items.

  • duplicate_plan

    Copy an existing plan with optional overrides for name, description, budget, dates, or themes.

  • list_plans

    List plans you own or that are shared with your team.

  • list_tasks

    List the strategic themes, goals, and tasks inside a plan.

Agent dispatch tools

These tools are for agents that pull queued work from RoryPlans. They require the right agentId, such as a Claude bridge ID created in Manage Agents.

  • get_next_task

    Claim the next pending dispatch task for an agent and receive its composed prompt.

  • list_pending_tasks

    List pending and claimed dispatch tasks for a specific agent ID.

  • complete_task

    Mark a dispatch task completed with a summary and optional agent output.

  • fail_task

    Mark a dispatch task failed with an error message.

How to connect

From the Claude Connectors Directory

  1. Open Claude and find RoryPlans in Connectors.
  2. Choose Connect and follow Claude's sign-in flow.
  3. Sign in to RoryPlans and authorize access when prompted.

Manual custom connector

  1. Sign in to RoryPlans and open API Tokens.
  2. In the OAuth client tab, create an OAuth client and copy the Client ID and Client Secret.
  3. In Claude, go to Settings > Connectors > Add custom connector.
  4. Paste the remote MCP URL https://www.roryplans.ai/api/mcp, then open Advanced and paste the OAuth Client ID and Client Secret.
  5. Click Add, then Connect, and finish sign-in in the browser if prompted.

Team or Enterprise Claude workspaces may require an owner to add the connector under Admin settings before members can connect it.

Authentication and access

RoryPlans uses OAuth 2.0 for Claude custom connectors. During authorization, you sign in to RoryPlans and Claude receives an access token scoped to your RoryPlans account. Connector data is scoped to your account and team permissions.

In the signed-in RoryPlans app, an active subscription is required to create API tokens or OAuth clients. OAuth authorization and token exchange also check that the authorizing RoryPlans user has an active subscription. Existing RoryPlans API tokens are accepted while they remain valid; revoke tokens you no longer want clients to use.

OAuth implementation details

  • Supported grants: authorization_code and client_credentials
  • PKCE support: S256
  • Client authentication: client_secret_post and client_secret_basic
  • /authorize
  • /api/mcp/oauth/token
  • /.well-known/oauth-authorization-server
  • /.well-known/oauth-protected-resource

Example prompts

  • "Create a RoryPlans plan for launching our customer onboarding campaign next month."
  • "Add a task to the launch plan to review connector docs with the support team."
  • "Use get_next_task for agent ID claude_cowork and complete the assigned work."

Troubleshooting

Claude asks you to sign in

Sign in with the RoryPlans account you want Claude to access. For manual OAuth clients, use the account that created the client. You need an active subscription to complete OAuth connection.

No plans found

Confirm you are signed in as the expected RoryPlans user and that the plan is owned by you or shared with your team.

No agent tasks appear

Dispatch tools only return queued work for the matching agent ID. Check the agentId from Manage Agents and make sure work has been dispatched.

Need help?

Read the setup details in API Tokens when you are signed in, or contact support@roryplans.ai.