Skip to main content

​
Prerequisites

You’ll need your Swoogo API credentials (consumer key and secret) from My Profile > API Credentials in Swoogo.

​
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. Enter your Swoogo API consumer key and secret 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 supports two authentication modes: Used by Claude Desktop, Cursor, and other GUI-based MCP clients. The server implements 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 entering your Swoogo API credentials
  3. The server issues encrypted access and refresh tokens
  4. Tokens are automatically refreshed — no manual re-authentication needed
Access tokens expire after 1 hour and are automatically refreshed. Refresh tokens are valid for 30 days.

​
Bearer token (CLI / scripts)

For programmatic access or CLI-based MCP clients:
  1. Base64-encode your credentials: base64(consumer_key:consumer_secret)
  2. Send as a Bearer token in the Authorization header
The server exchanges this for a Swoogo API token on each request and caches it until expiry.

​
Common parameters

Most read tools share these optional parameters:

​
Error handling

The server returns helpful error messages with recovery hints: