This is a limited test release. Read more…

wewent.to – Help

wewent.to lets you document journeys together with your travelmates using maps, GPS tracks, and photos. This guide explains how to create journeys, manage access, and add content.

Table of Contents

1. Journeys

A journey lets you document your shared experience on land or sea, be that an Atlantic crossing or a walk in the park. It combines a map with photos and GPX tracks contributed by multiple users.

Back to top

2. Creating a Journey

  1. Sign in to your wewent.to account.
  2. Open the Journeys page.
  3. Click the Create button.
  4. Enter a name and an optional description.
  5. Confirm to create the journey.

The user who creates a journey becomes its creator and controls its settings and access.

Automatic Location Labels

When you upload GPX tracks, the system automatically generates descriptive location labels (e.g., countries, regions, or mountain ranges) based on the journey's geography. These labels help you and others quickly identify where the journey took place.

As the journey creator, you can manually edit or refine these labels at any time from the journey page.

Back to top

3. Editing Journey Details

The journey creator can edit:

  • The journey name
  • The journey description
  • Location labels

Changes are saved immediately and visible to everyone who has access to the journey.

Back to top

4. Privacy & Access Control

The creator of the journey manages the access rights to it. Only authorized users can add content to the journey. A journey can be either public or private.

Public Journeys

  • Visible to anyone on wewent.to.
  • Appear on the Explore page.

Non-Public Journeys

  • Visible only to selected users.
  • Not shown in public listings.
The creator can allow specific users to view a non-public journey without granting permission to add content.

Back to top

5. Roles & Permissions

  • Creator – Full control over the journey, its content, and access.
  • Contributor – Can add photos and GPX tracks.
  • Viewer – Can view the journey but cannot add content.

Back to top

6. Adding Photos and GPX tracks

  1. Open the journey.
  2. Click the Add button.
  3. Select one or more image and GPX files.
  4. Upload the files.

GPX tracks are displayed on the map; their names are listed next to the map.

Photos appear as thumbnails below the map and as markers on the map when GPS data is available.

Clicking a thumbnail opens a full size image. You can navigate between photos using the keyboard arrow keys or the Next and Previous buttons on either side of the image overlay.

7. Importing from Google Drive

Pick GPX tracks and photos directly from Google Drive instead of manual uploads. wewent.to only ever accesses the files you explicitly select in the Google Picker — never your whole Drive.

Connecting Google Drive

  1. Go to a journey you can contribute to (Creator or Contributor).
  2. Open Add media and click Choose files from Google Drive.
  3. A Google sign-in popup asks you to grant access to files you select with wewent.to (scope drive.file). Optionally, you can also grant drive.readonly to enable thumbnail previews in the Picker's GRID view.
  4. Grant permission. The consent screen no longer mentions reading all your Drive files.

Connecting once is enough: wewent.to keeps an encrypted access credential (not your files) so imports work without reconnecting every time. Manage it under Connected accounts: revoke there to disconnect Google completely. If access stops working (e.g. you revoked it at Google), the connection shows Reconnect required — reconnect and re-run the import; partial progress is kept. If you previously granted the old full-Drive read access, Google shows a scope change on next connect — this is expected.

Picking files

  1. Click Choose files from Google Drive. The Google Picker opens.
  2. By default, the Picker opens in GRID mode showing big image thumbnails. If you did not grant the drive.readonly scope (or uncheck Show thumbnails in the dialog), it falls back to LIST mode with small thumbnails.
  3. Browse folders and multi-select the files to import. Folder selection itself is disabled — open a folder and pick the files inside it.
  4. Confirm the Picker selection. Files download and are added to your journey.
  5. The Picker shows all file types, but only GPX files and images can be imported by wewent.to.

Supported File Types

  • Images: JPEG (.jpg, .jpeg), PNG (.png), HEIC (.heic), HEIF (.heif)
  • Tracks: GPX files (.gpx, detected by extension even when Drive reports a generic MIME type)

Important Notes

  • Maximum 50 files per import (enforced in the Picker and on the server).
  • Individual files over 10 MB are skipped.
  • Folders, Google-native documents (Docs, Sheets, Slides), shortcuts, trashed files, unsupported types, and files you can no longer access are skipped with a per-reason breakdown — the rest of the batch still imports.
  • Selecting the same file twice in one import counts once (duplicates are deduped). Files already imported earlier are imported again — there is no cross-import dedupe.
  • Your Google account must have access to each selected file. If a file was trashed or unshared after picking, it is reported as trashed or inaccessible without failing the batch.
  • If the import reports an expired token, reconnect (popup or Connected accounts page) and re-run it — already imported files are kept.
  • If the Google script fails to load (offline, blocked, ad blocker) the Picker button shows an error and the rest of the Add-media dialog still works. Popup blockers and in-app mobile browsers can break the sign-in or Picker popups — allow popups for this site and retry.
For files shared with you: open them in Google Drive first so your account has access, then pick them in wewent.to. Picking a folder does not grant access to its children — always pick the files themselves.

Back to top

8. Editing Photo Descriptions

Users can edit the descriptions of photos they uploaded themselves.

Back to top

Back to top

9. Viewing a Journey

  • Explore photos and tracks on an interactive map.
  • Browse photos via thumbnails and full-size overlays.
  • Follow the geographical story of the journey.

Back to top

10. Commenting & Replies

You can engage with journey content through comments and replies. Comments can be added to journeys and individual photos.

Adding Comments

  • Journey Comments: Scroll to the bottom of any journey page and use the comment form to share your thoughts about the journey.
  • Photo Comments: Open a photo in full view and add comments directly on the image to discuss specific moments.

Threaded Replies

Comments support nested replies, allowing for threaded conversations:

  1. Click the Reply button under any comment to respond directly.
  2. Your reply will appear indented below the original comment.
  3. You cannot reply to a reply — keep conversations organized by replying to the top-level comment.

Editing and Deleting Comments

  • Edit: Click the Edit button on your own comments to modify the text.
  • Delete: Use the Delete button to remove your comments. Comments with replies will be soft-deleted (hidden but preserved for context).
Only registered users who can contribute to a journey (Creators and Contributors) can add comments. Viewers can see comments but cannot add their own.

Guest Interaction: If you are a guest viewing a public journey, you can log in or register directly through a modal window by clicking the Log in to comment button. This allows you to join the conversation without losing your place on the page.

Back to top

11. Reactions

Reactions let you quickly show appreciation or engagement with journey content using emojis.

Available Reactions

Click the reaction buttons to add your response:

  • 👍 Like – Show appreciation or agreement
  • 😄 Haha – Indicate something is funny or amusing
  • 😢 Sad – Express sympathy or sadness
  • 😠 Angry – Show disagreement or frustration

Where You Can React

  • Journeys: React at the top of any journey page.
  • Photos: Open a photo and react using the buttons below the image.
  • Comments: React to individual comments on photos and journeys.

Managing Your Reactions

  • Clicking the same reaction again removes it.
  • Clicking a different reaction type replaces your previous reaction.
Only registered users can react to content. Reactions are visible to everyone with access to the content and can be used to gauge engagement and sentiment.

Guest Interaction: Guests can log in or register via a modal when attempting to react to content, allowing them to participate seamlessly.

Back to top

12. Forking Journeys

Forking creates your own editable copy of a public journey, useful for building on someone else's adventure or starting fresh with existing tracks.

How to Fork a Journey

  1. Browse public journeys on the Explore page.
  2. Open the journey you want to fork.
  3. Click the Fork button (usually near the journey title).
  4. A new journey is created with all GPX tracks copied to your account.

What Gets Forked

  • All GPX tracks are cloned into your new journey.
  • The journey name and description are copied.
  • Your forked journey starts with private visibility (restricted access).
  • Photos are not copied – you can add your own photos to the tracks.
You cannot fork your own journeys. Only registered users can fork journeys. Forked journeys maintain a reference to the original source.

Back to top

13. Inviting Travelmates

Share private journeys with friends by inviting them to become viewers or contributors.

Sending an Invitation

  1. Open your journey.
  2. Click Invite in the button bar.
  3. Enter the invitee's email address.
  4. Select their role: Viewer (can view only) or Contributor (can add content).
  5. Add a personal message. This is not mandatory, but recommended. It greatly reduces the chances that your invitation will be mistaken for spam.
  6. Click Send Invitation.

Guest Access vs. Registered User

  • Guest Access: The invitation link allows access without an account initially. Guests can view the journey but must create an account to add content.
  • Registered Contributor: When an invited user registers with the same email, they become a full contributor with the role you assigned.

Managing Invitations

  • Invitations are sent via email with a unique link.
  • The invite link expires after seven days.
  • Only the journey creator can send invitations.
  • No more than 10 invitations per hour per user are allowed.
Your email must be verified before you can send invitations.

Back to top

14. Activity Feed & Notifications

The Feed page keeps you updated on the latest activity across the wewent.to community and your social circle.

Notifications You'll Receive

  • New Followers: When another user starts following you.
  • Content Added: When someone adds photos or tracks to a journey you have access to.
  • Comment Replies: When someone responds to one of your comments.
  • Social Activity: When users you follow create new public journeys or contribute to others.
  • Access Changes: When you are granted or revoked access to a private journey.

Notifications are displayed in reverse chronological order, allowing you to quickly jump to the relevant journey or profile.

Back to top

15. Following & Profiles

Connect with other travelers through the People directory and personal Profiles.

The People Directory

The People page lists all registered users. You can browse their avatars, usernames, and optional personal tags or descriptions.

User Profiles

Clicking on a user in the directory opens their public profile. Here you can see:

  • Their identity details (username, tag, and bio).
  • A list of all their journeys that you are permitted to view.

Following Users

You can Follow other users from their profile page. Following a user ensures their new public journeys and contributions appear in your Activity Feed. You can unfollow at any time.

Back to top

16. Personal Tags

Organize journeys for your own discovery using Personal Tags.

How Personal Tags Work

  • Private by Design: Tags you add to a journey are only visible to you. Other users, including the journey creator, cannot see your personal tags.
  • Universal Access: You can add your own tags to any journey you have permission to view, even if you aren't a contributor.
  • Easy Organization: Use tags to categorize journeys by theme (e.g., "hiking", "sailing", "2024-plans") for easy filtering on the Explore and Journeys pages.

Adding and Editing Tags

  1. Open any journey you can view.
  2. Locate the tag section beneath the journey title.
  3. Click to add or edit tags. Your changes are saved privately to your account.
Anonymous users cannot see or create tags. You must be logged in to manage your personal tagging system.

Back to top

17. API Tokens

API tokens (personal access tokens) let external tools – such as AI assistants – act on your behalf through the wewent.to API. Each token starts with wwt_pat_ and carries its own set of permissions, so you decide exactly what a connected tool may see and do.

Creating a Token

  1. Sign in and open your Account Settings.
  2. Click the Manage API tokens button.
  3. Enter a descriptive name (e.g., ChatGPT Travel Assistant) so you can later recognize what the token is used for.
  4. Select at least one permission. Permissions are grouped by area: Journeys, Photos, Tracks, Waypoints, Social, and Profile and extras. Grant only what the tool actually needs.
  5. Choose the journey access: All journeys I can access, or Selected journeys only and pick the journeys from the list.
  6. Click Create token.

Account Settings page with the avatar, user tag and description fields. Below the Save button sits the Manage API tokens button, highlighted with a red rectangle.

The API Tokens page lists your existing tokens and, below them, the form for creating a new one:

The API Tokens page of a new user: an empty-state message reading 'You have not created any API tokens yet.' followed by the Create a new token form with a name field, permission checkboxes grouped by area, and a journey-access dropdown.

The following example sets up a read-mostly assistant: it may view journeys, photos and tracks, add photos, and read comments – but only for two selected journeys.

Create-a-new-token form filled in for 'ChatGPT Travel Assistant'. The checked permissions are View journeys, View photos, Add and edit photos, View tracks and Read comments. Journey access is set to Selected journeys only, revealing a multi-select list with the journeys Alpine Hike 2026 and Sailing to Terschelling selected.

The One-Time Token Value

After creation, the full token value is displayed in a highlighted box. Copy it immediately – it is shown exactly once and cannot be retrieved later, neither by you nor by wewent.to. If you lose it, simply create a new token.

Highlighted box with the warning 'Copy this now — it will not be shown again.', the plaintext token value starting with wwt_pat_, and a Copy button.

Managing Existing Tokens

  • Each token card shows its masked value (wwt_pat_•••• followed by the last four characters), the Created and Last used dates, the journey scope, and a status pill (Active or Revoked).
  • You can rename a token or change its permissions and journey access at any time, then save your changes.
  • Revoke immediately and permanently invalidates a token. Revoking never affects your browser sessions or your account.
  • Revoked tokens remain in the list, greyed out, for reference. They cannot be re-activated.

Token list showing one active card named 'ChatGPT Travel Assistant' with an Active pill, the masked value wwt_pat_•••• plus hint characters, created and last-used dates, journey scope 'Selected journeys only', inline edit fields for name, permissions and journey access, and Save and Revoke buttons.

A token can never do more than you can: its effective permissions are defined by all three: the selected permissions (scopes), your own role on each journey (creator, contributor or viewer) and, if set, the selected-journeys restriction.
Treat token values like passwords: store them securely, never share them, and revoke tokens you no longer use.

Back to top

18. Connecting AI Agents via MCP

Upon your explicit permission, the wewent.to MCP (Model Context Protocol) server lets authorized AI agents — such as Claude, ChatGPT, OpenCode, OpenHands, Cursor, GitHub Copilot, Zed, Goose, Cline, LM Studio, Devin and others — read and write your travel data: journeys, GPS tracks, photos, waypoints, comments, and reactions.

The agent never gets your password. Instead you create a Personal Access Token (PAT) or approve an OAuth 2.1 consent screen. Both credentials are scoped by three independent layers:

  • PAT scopes / OAuth scopes — which kinds of data the token may touch (e.g. journeys:read, photos:write)
  • Your journey role — Creator / Contributor / Viewer (same permission engine as the web UI)
  • Journey restriction — optional allow-list: All journeys I can access or Selected journeys only

Effective permission is defined by all three: the scope, your role (creator, contributor or viewer) and journey restriction.

Quick Start (PAT — works with most agents)

  1. Sign in to wewent.to and open Account Settings → Manage API tokens.
  2. Click Create token.
  3. Name it (e.g. Claude Travel Assistant).
  4. Pick the scopes the agent needs (see the Scope Catalogue below).
  5. Choose Journey access: All journeys I can access or Selected journeys only.
  6. Click Create token → copy the value immediately (wwt_pat_… — shown once only).
  7. In your AI agent, add a custom MCP connector pointing at:
    https://wewent.to/api/mcp
    with header Authorization: Bearer .
  8. Test with a simple prompt: “List my journeys”.

Free vs. Paid Tiers

The table below shows which agents offer MCP on a free tier. All agents listed support Bearer PAT; those marked OAuth also support the OAuth 2.1 flow (required for claude.ai, ChatGPT custom connectors, and the Claude mobile apps).

Agent Free tier PAT (Bearer) OAuth 2.1
Claude (web, desktop, mobile) ✅ Only one custom connector in the free tier ✅ ✅
ChatGPT ✅ ✕ ✅
Gemini ✅ ✕ ✅
Mistral Le Chat ✅ ✅ ✅ Auto-detects sign-in method
VS Code + GitHub Copilot Free ✅ MCP on Copilot Free ✅ ✅
Codex CLI / app ✅ Limited Codex on ChatGPT Free ✅ ✅
Goose ✅ ✅ ✅
Cline ✅ ✅ ✅
Zed ✅ ✅ ✅ Setting Authorization header disables OAuth
LM Studio ✅ ✅ ✅
Devin Desktop (formerly Windsurf) ✅ Small quota ✅ ✅
Cursor ✕ Pro/Business only ✅ ✅

Key distinction:
• PAT = you paste wwt_pat_… into the agent’s “Bearer token” / “Request header” field.
• OAuth 2.1 = the agent redirects you to wewent.to, you approve scopes + journey restriction on a consent screen, the agent receives wwt_oat_… (1 h access token) + wwt_ort_… (30-day rotating refresh token).

Claude (web / desktop / mobile)

Free plan: one custom connector.

PAT method (simplest)

  1. In Claude → Settings → Connectors → Add custom connector.
  2. Name: wewent.to
    URL: https://wewent.to/api/mcp
    Auth type: Bearer token
    Header: Authorization: Bearer wwt_pat_… (paste your PAT).
  3. Save → enable the connector.

OAuth method (required for claude.ai & mobile apps)

  1. In Claude → Settings → Connectors → Add custom connector.
  2. Name: wewent.to
    URL: https://wewent.to/api/mcp
    Auth type: OAuth 2.1
    Client registration: choose “Register automatically” (do not use the recommended default).
  3. Save → Claude will open wewent.to consent screen → approve scopes + journey restriction.
  4. Done — token refresh is automatic.

ChatGPT

Only OAuth 2.1 — no raw Bearer field.

  1. ChatGPT → Plugins → Add → Add custom MCP server.
  2. Name: wewent.to
    Description: Group travel diary
    Connection: https://wewent.to/api/mcp
    Authentication: OAuth
    Auth type: OAuth 2.1.
  3. ChatGPT performs Dynamic Client Registration (DCR) → redirects to https://wewent.to/oauth/authorize.
  4. Sign in to wewent.to if needed → approve scopes + journey restriction → Allow.
  5. ChatGPT stores the rotating token pair; you never see the raw token.

Gemini

Only OAuth 2.1 — no raw Bearer field.

  1. Gemini → Customize → Connectors → +Custom.
  2. MCP Server URL: https://wewent.to/api/mcp
  3. Gemini performs Dynamic Client Registration (DCR) → redirects to https://wewent.to/oauth/authorize.
  4. Sign in to wewent.to if needed → approve scopes + journey restriction → Allow.
  5. Gemini stores the rotating token pair; you never see the raw token.

Codex CLI / App

Free tier includes limited Codex.

PAT

export CODEX_MCP_WEWENT_TO_TOKEN="wwt_pat_..."
codex mcp add wewent.to https://wewent.to/api/mcp

OAuth

codex mcp login wewent.to https://wewent.to/api/mcp
# Opens browser → approve on wewent.to consent screen

OpenCode

OpenCode uses a local config file. Create ~/.config/opencode/mcp.json:

{
  "mcpServers": {
    "wewent.to": {
      "url": "https://wewent.to/api/mcp",
      "headers": { "Authorization": "Bearer wwt_pat_..." }
    }
  }
}

Restart OpenCode. The server will appear in /mcp command output.

OpenHands

OpenHands reads MCP config from .openhands/mcp.json in your project or ~/.openhands/mcp.json:

{
  "mcpServers": {
    "wewent.to": {
      "url": "https://wewent.to/api/mcp",
      "headers": { "Authorization": "Bearer wwt_pat_..." }
    }
  }
}

Restart the OpenHands agent.

Mistral Le Chat

Mistral Le Chat supports custom connectors via its settings. Add a new connector with URL https://wewent.to/api/mcp and the PAT in the Authorization header. OAuth 2.1 is also supported and auto-detects the sign-in method.

VS Code + GitHub Copilot Free

In VS Code with GitHub Copilot Free, add the MCP server in your settings.json:

{
  "mcp": {
    "servers": {
      "wewent.to": {
        "url": "https://wewent.to/api/mcp",
        "headers": { "Authorization": "Bearer wwt_pat_..." }
      }
    }
  }
}

Or use the Copilot Chat interface to add the connector. Callback URLs are HTTPS or localhost (accepted by wewent.to).

Goose

Goose accepts a JSON config file. Add the server with URL https://wewent.to/api/mcp and the PAT in the Authorization header. OAuth 2.1 is also supported.

Cline

Cline uses a JSON config. Set "type": "streamableHttp" in your config:

{
  "mcpServers": {
    "wewent.to": {
      "type": "streamableHttp",
      "url": "https://wewent.to/api/mcp",
      "headers": { "Authorization": "Bearer wwt_pat_..." }
    }
  }
}

Zed

Zed accepts a JSON config with url + headers (PAT) or auth: { type: "oauth2" } (OAuth). Note: setting an Authorization header turns OAuth off.

LM Studio

LM Studio supports MCP servers in its configuration. Add https://wewent.to/api/mcp with the PAT in the Authorization header. OAuth 2.1 is also supported.

Devin Desktop (formerly Windsurf)

Devin accepts MCP configuration with URL https://wewent.to/api/mcp and the PAT in the Authorization header. OAuth 2.1 is also supported.

Cursor

Cursor (Pro/Business) supports MCP servers. Add the connector with URL https://wewent.to/api/mcp and the PAT in the Authorization header. OAuth 2.1 is also supported.

Other Agents

The agents above all accept a JSON config with url + headers (PAT) or auth: { type: "oauth2" } (OAuth). Consult each agent's documentation for the exact file location; the values are identical to the examples above.

Scope Catalogue — What Each Permission Allows

ScopeAllowsTypical use-case
profile:readYour own profile (email, avatar, tags)“Who am I?”
journeys:readList / retrieve journeys you can view“Show my trips”
journeys:writeCreate / edit journey metadata“New trip: Iceland 2026”
journeys:deleteSoft-delete a journey“Remove that test journey”
journeys:shareGrant / revoke / change access“Add Alice as contributor”
photos:readPhoto metadata + thumbnails“Show photos from journey X”
photos:read_originalDownload full-resolution originals“Export hi-res images”
photos:writeUpload, caption, attach to waypoints“Add these sunset photos”
photos:deleteDelete photos“Remove blurry shots”
tracks:readTrack metadata + geometry summary“What’s the distance?”
tracks:read_originalDownload original .gpx“Export to Garmin”
tracks:writeUpload GPX tracks“Import my watch track”
tracks:deleteDelete tracks“Remove duplicate track”
waypoints:readRead waypoints“List anchorages”
waypoints:writeAdd / edit waypoints (planned)—
waypoints:deleteDelete waypoints (planned)—
comments:readRead comments & replies“What did Bob say?”
comments:writeAdd / edit comments (planned)—
reactions:readRead reaction counts“How many 👍?”
reactions:writeAdd / remove reactions (planned)—
users:readSearch / view other users (where UI permits)“Find @alps23”
export:readExport aggregated journey data“Give me my 2025 stats”

Rule of thumb: grant the minimum scopes the agent needs. A read-only travel assistant only needs profile:read, journeys:read, photos:read, tracks:read, comments:read, reactions:read.

Available Tools (What the Agent Can Actually Do)

Read Tools (shipped)

ToolDescriptionRequired scope(s)
search_journeysFiltered, paginated journey list (200 max)journeys:read
get_journeySingle journey enriched summaryjourneys:read
get_journey_timelineCombined tracks/waypoints in timeline orderjourneys:read
get_journey_contributorsContributor user IDs for a journeyjourneys:read
search_tracksFiltered track list with GPX URL refstracks:read
search_waypointsFiltered waypoint listwaypoints:read
get_waypointSingle waypoint enriched summarywaypoints:read
list_photosJourney-scoped photo list with URL refsphotos:read
search_photosCross-journey photo search (incl. proximity)photos:read
get_binary_resourceDownload bytes for any /uploads/… URLvaries by URL class
get_profileYour own profile (private fields included)profile:read
get_userPublic profile of another userusers:read
get_gdrive_connection_statusCheck your Google Drive link status(none — self-scoped)
list_commentsJourney comments (top-level, with replies)comments:read
get_reactionsAggregated journey reactionsreactions:read

Write Tools (shipped)

ToolDescriptionRequired scope(s)
create_journeyNew journey (name, description, privacy)journeys:write
update_journeyEdit name, description, privacy, tags, labelsjourneys:write
delete_journeySoft-delete a journeyjourneys:delete
grant_access / revoke_access / update_roleManage journey collaboratorsjourneys:share
upload_photosBase64 image upload (max 10 MB, 50 files)photos:write
upload_tracksBase64 GPX uploadtracks:write
remove_photos / remove_tracksDelete mediaphotos:delete / tracks:delete
set_image_caption / set_track_captionUpdate captionsphotos:write / tracks:write
prepare_upload / get_upload_statusCapability-URL upload (large batches)photos:write / tracks:write
import_gdrive_filesImport from your linked Google Drivephotos:write + tracks:write

Planned (not yet implemented): create_waypoint, update_waypoint, delete_waypoint, attach_images_to_waypoint, add_comment, add_reply, add_reaction, remove_reaction.

Security Best Practices

  • Treat PATs like passwords — store in a secret manager, never post online or disclose to other people.
  • Use journey restriction — limit tokens to only the journeys the agent needs.
  • Revoke unused tokens — /account/tokens → Revoke.
  • Rotate periodically — create new, revoke old.
  • Prefer OAuth for long-lived integrations — refresh tokens rotate automatically; PATs are static.
  • Monitor “Last used” on /account/tokens to detect stale tokens.

Troubleshooting

SymptomLikely causeFix
“Unauthorized” on first callPAT typo / revoked / legacy PAT without lookup hashRegenerate token at /account/tokens
“Forbidden: token lacks required scope ‘X’”Scope not granted on tokenEdit token → add scope → save
“Journey not found or access denied”Journey is private / you’re only a viewer / PAT restricted to other journeysAdjust journey restriction or grant contributor role
OAuth consent screen never appearsConnector didn’t register automatically / redirect URI mismatchIn Claude: pick “Register automatically”; ensure redirect URI is exact
Large upload failsBase64 payload > 50 MB limitUse prepare_upload + capability-URL data plane
get_binary_resource returns 10 MB cap errorFile larger than 10 MBMake the file smaller

Frequently Asked Questions

Q: Can I use the same token for multiple agents?
A: Yes, but we recommend one token per agent so you can revoke independently.
Q: Does the agent see my password?
A: Never. PATs and OAuth tokens are independent credentials.
Q: Can a token with journeys:read see private journeys?
A: Only if you are a viewer/contributor/creator of that journey and the token’s journey restriction allows it.
Q: What happens when I revoke a token?
A: Immediate — the token stops working. Your browser sessions are unaffected.
Q: Can I use MCP from a local script (curl, Python)?
A: Yes — POST https://wewent.to/api/mcp with Authorization: Bearer wwt_pat_… and JSON-RPC 2.0 body.
Q: Why does search_journeys return max 200 results?
A: To avoid overwhelming the agent with data, search_journeys implements a capped keyset-cursor pagination. Cursor-walk via modifiedFrom/modifiedTo with sort recent to page further.

19. Manage Connected Apps

The Connected Apps page (/account/connected-apps) lists every OAuth 2.1 client you have authorized to access your wewent.to data via the MCP server. Each entry shows the client name, the date you granted access, the scopes you approved, and any journey restriction you selected.

You can revoke an app at any time. Revoking immediately invalidates both the access token and its refresh token pair, and the app can no longer call the MCP endpoint on your behalf. Revoking never affects your browser sessions or your account.

How to revoke:

  1. Open Account Settings → Connected Apps.
  2. Find the app you want to remove.
  3. Click Revoke and confirm.
This only affects OAuth 2.1 clients (e.g. Claude.ai, ChatGPT custom connectors). Personal Access Tokens (PATs) are managed separately on the API Tokens page.

20. Manage Connected Accounts

The Connected Accounts page (/account/connections) manages external service linkages — currently only Google Drive. When you import photos or GPX tracks from Google Drive, wewent.to stores an encrypted refresh token so future imports work without re-authenticating.

Each connection shows its status:

  • Connected — the linkage is active and imports will work.
  • Reconnect required — the refresh token expired or was revoked at Google; click Reconnect to restore access.

To disconnect Google Drive: click Revoke on the Connected Accounts page. This deletes the encrypted credential from wewent.to. You can reconnect later by starting a new Google Drive import from any journey.

Disconnecting Google Drive does not delete any photos or tracks you have already imported — those remain in your journeys.

Back to top