Connect an AI agent to Spote via MCP

Spote exposes a built-in MCP (Model Context Protocol) server that lets AI agents like Claude read and write your notes without you leaving the conversation. Once connected, you can tell your agent to save a summary, search for a past decision, or list your recent notes — all through natural language.

Claude Desktop
ChatGPT
GitHub Copilot
Other MCP clients

Use Spote with Claude Desktop

Open Claude Desktop and click on Customize
Click Add (up to the right in Add custom connector window)
In the Add custom connector dialog, type Name: Spote, Remote MCP Server URL: https://spote.cloud/mcp. Click Continue
In next dialog, the settings should be fine (Authentication: Always required, OAuth client: No client ID). Click Add

Verify that you can see 10-15 tools for Spote. If not (Claude might not always authenticate the user initially), disconnect Spote and connect again. You might even need to restart Claude Desktop before the installation completes.

Use Spote with GitHub Copilot in VS Code

First, install and sign in to the GitHub Copilot extension. Then choose one of the following configuration options.

Option 1: Configure Spote for one project

Create .vscode/mcp.json in the project root:

{
  "servers": {
    "spote": {
      "type": "http",
      "url": "https://spote.cloud/mcp",
      "oauth": {
        "clientId": "WuLeZvgUbb4OtKxv"
      }
    }
  }
}

This makes Spote available only in that project.

Option 2: Configure Spote globally

Open the VS Code Command Palette:
- macOS: Cmd+Shift+P
- Windows/Linux: Ctrl+Shift+P
Select MCP: Open User Configuration.
Add the same configuration to the global mcp.json file:

{
  "servers": {
    "spote": {
      "type": "http",
      "url": "https://spote.cloud/mcp",
      "oauth": {
        "clientId": "WuLeZvgUbb4OtKxv"
      }
    }
  }
}

This makes Spote available across all VS Code projects.

Connect to Spote

Open the Command Palette and select MCP: List Servers.
Start spote.
Sign in to Spote and approve the requested permissions.
Open GitHub Copilot Chat and select Agent mode.

Spote’s tools should now be available to GitHub Copilot.

Choose either the project-level or global configuration. The Client ID is public and safe to include; no Client Secret is required.

Connect Spote to Other AI Agents

Add your regional Spote MCP endpoint using your agent’s MCP configuration.

Agents with automatic OAuth registration

If the agent supports automatic OAuth client registration:

Add the Spote MCP endpoint https://spote.cloud/mcp.
Start the connection.
Sign in to Spote when the browser opens.
Review and approve the requested permissions.

The agent registers itself automatically. No Client ID or Client Secret is required.

Agents requiring a Client ID

If the agent asks for an OAuth Client ID, use the Spote public Client ID:

WuLeZvgUbb4OtKxv

Do not enter a Client Secret. Spote uses OAuth Authorization Code with PKCE for supported public clients.Complete the browser sign-in when prompted.

Troubleshooting

If authentication fails:

Confirm that you are using the correct regional Spote MCP endpoint.
Remove any previously cached authentication for Spote and try again.
Confirm that your agent supports remote MCP servers and OAuth with PKCE.
Contact Spote support if the agent reports invalid_client or redirect_uri_mismatch, as the agent might require additional server-side registration.

Step 3: Test the connection

After saving your configuration and restarting your AI tool, start a new conversation and ask:

“List all tools in Spote”

Your agent should respond with information of all the tools provided by Spote.

Get Started

Core Concepts

Guides

MCP Integration

Connect an AI agent to Spote via MCP

Use Spote with Claude Desktop

Use Spote with ChatGPT

Use Spote with GitHub Copilot in VS Code

Option 1: Configure Spote for one project

Option 2: Configure Spote globally

Connect to Spote

Connect Spote to Other AI Agents

Agents with automatic OAuth registration

Agents requiring a Client ID

Troubleshooting

Step 3: Test the connection

​Use Spote with Claude Desktop

​Use Spote with ChatGPT

​Use Spote with GitHub Copilot in VS Code

​Option 1: Configure Spote for one project

​Option 2: Configure Spote globally

​Connect to Spote

​Connect Spote to Other AI Agents

​Agents with automatic OAuth registration

​Agents requiring a Client ID

​Troubleshooting

​Step 3: Test the connection

Use Spote with Claude Desktop

Use Spote with ChatGPT

Use Spote with GitHub Copilot in VS Code

Option 1: Configure Spote for one project

Option 2: Configure Spote globally

Connect to Spote

Connect Spote to Other AI Agents

Agents with automatic OAuth registration

Agents requiring a Client ID

Troubleshooting

Step 3: Test the connection