Skip to main content

​
Prerequisites

Log in to Swoogo with an account that has the Access API permission enabled. No separate API credentials are needed, the MCP server uses your Swoogo login via OAuth.

​
Connect your client

1

Add the server

Open Claude Desktop settings and add the Swoogo MCP server URL:
2

Authorize

Claude Desktop will open a browser window. Log in with your Swoogo account to authorize access.
3

Start using tools

The Swoogo tools will appear in Claude Desktop. Try asking: “Show me my upcoming events”

​
Authentication

The MCP server authenticates with OAuth 2.0 Authorization Code with PKCE (RFC 7636):
  1. Your MCP client discovers the OAuth endpoints via /.well-known/oauth-authorization-server
  2. You authorize in the browser by logging in with your Swoogo account
  3. The server issues encrypted access and refresh tokens
  4. Tokens are automatically refreshed, with no manual re-authentication needed
Access tokens expire after 1 hour and are automatically refreshed. Refresh tokens are valid for 30 days.

​
Common parameters

Most read tools share these optional parameters:

​
Error handling

The server returns helpful error messages with recovery hints: