VOGSY MCP Server

The VOGSY MCP server connects VOGSY to AI assistants that support the Model Context Protocol (MCP), such as Claude, ChatGPT, Microsoft Copilot and Gemini Enterprise. Once connected, you can ask the assistant to look things up or take actions in VOGSY directly from a chat conversation. For example checking your planning, submitting a timesheet, creating a task, or drafting a new project, without needing to open the VOGSY application yourself.

The server is available at the following URL, which you'll need when setting up the connection in your AI assistant: https://mcp.vogsy.io

Behind the scenes, the assistant does this by calling a set of predefined "tools." Each tool corresponds to a specific piece of functionality in VOGSY, such as reading a person's availability or creating a new deliverable. This page lists every tool that is currently available, grouped by topic, so you know what you can ask the assistant to help with.

A few things worth knowing before you start:

• You stay in control. Before the assistant creates or changes anything in VOGSY (a timesheet, a project, a resource allocation, and so on), it will first summarize what it's about to do and ask you to confirm.

• The assistant looks things up first. For most actions, it will retrieve the relevant record or form from VOGSY before making a change, so it's working with your current data and the correct options rather than guesses.

• You don't need to know the tool names. Just describe what you want in plain language, e.g. "log 8 hours on the Acme project for yesterday" or "who's available next week for the DiUS project?" The assistant will figure out which tools to use.

• This list is a reference, not a menu. You don't need to invoke tools by name; they're listed here mainly so you can see the full range of what's possible, and so more technical readers can understand how requests are handled under the hood.

For a complete, detailed breakdown of every tool, including exactly what data each one reads or writes, see the attached VOGSY MCP Server – Tool Reference (PDF).

Most AI assistants connect to VOGSY in a few clicks. Add the VOGSY MCP server as a connector and sign in with your VOGSY account. No Client ID or secret needed: the assistant registers itself automatically through Dynamic Client Registration.

Example: Claude

1. In Claude, open Settings and go to Connectors.

2. Click Add custom connector.

3. Enter VOGSY as the name and https://mcp.vogsy.io as the URL.

4. Click Connect and sign in with your VOGSY account.

Other assistants, such as ChatGPT and Microsoft Copilot, work the same way: add https://mcp.vogsy.io as a custom MCP server or connector.

Your assistant asks for a Client ID? Then it doesn't support Dynamic Client Registration. For Gemini Enterprise, follow the steps below. For other tools, contact us at support@vogsy.com. We may be able to provide a dedicated Client ID.

Gemini Enterprise connects to VOGSY differently from most AI assistants. It doesn't support Dynamic Client Registration, so it can't register itself with VOGSY automatically. Instead, you enter the client registration details yourself, using a Client ID that VOGSY provides for Gemini Enterprise. Setup takes a few extra fields, after which you use your VOGSY data directly in Gemini.

1. In Gemini Enterprise, open Settings and go to Connected apps.

2. Click Add MCP server.

3. Enter the server details:

   • Server URL: https://mcp.vogsy.io

   • Name: VOGSY

4. Enter the authorization details:

   • Authorization URL: https://vogsy.io/oauth2/authorize

   • Token URL: https://vogsy.io/oauth2/token

   • Client ID: qvLpV8MBFYhhlLwmdE2QvVLx

   • Client secret: any value, for example no secret

   • Scopes: email offline_access openid profile vy.all.write

5. Save the MCP server and sign in with your VOGSY account.

Why any client secret works: Gemini Enterprise requires a value in the client secret field, but VOGSY doesn't use it. For this Client ID, VOGSY uses PKCE (Proof Key for Code Exchange), a more secure alternative to a fixed secret.

This Client ID is provided by VOGSY, so you don't need to request or create one yourself. Copy it exactly as shown above. It only works with Gemini Enterprise.