WorkStory MCP · Gemini

Connect WorkStory to Gemini.

Add the WorkStory MCP server to Gemini, then ask about feedback, reviews, review cycles, and team context in plain language.

Connect it ↓ See what you can ask →
✓ Your company only✓ Your permissions only✓ Feedback requests need approval
WorkStory
+
GeminiGemini
Gemini● WorkStory connected
Summarize the recurring feedback themes for my team this quarter and flag anything that changed.
Three themes stand out in the WorkStory feedback you can access — one is new since last quarter:
Ownership
21
Communication
17
Prioritization · new
12
Connect it

Pick the Gemini you use.

Gemini comes in more than one form, and each connects to WorkStory a different way. Find yours below, then follow that card.

If you useGemini CLI in your terminal→ add WorkStory as an MCP server in settings.json
If you useThe Gemini app at work, or Gemini Enterprise→ your Google Workspace admin adds WorkStory as a connector

Gemini CLI

For: anyone running Gemini from the command line. You connect it yourself — no admin needed.

1
Open your Gemini CLI settings.

Edit ~/.gemini/settings.json for all projects, or .gemini/settings.json inside one project.

2
Add WorkStory as an MCP server.

Add this to the mcpServers block (create it if it isn't there).

{ "mcpServers": { "workstory": { "httpUrl": "https://app.workstory.team/mcp" } } }
3
Restart Gemini CLI and sign in.

Run /mcp to confirm WorkStory is listed. The first time you use it, Gemini opens WorkStory so you can log in and approve access.

4
Ask a question normally.

Mention WorkStory, a person, team, or review cycle when you want an answer grounded in your data.

Gemini app & Gemini Enterprise

For: teams using Gemini inside Google Workspace, or Gemini Enterprise. Connectors are managed centrally, so this is an admin step.

1
Check that your plan supports MCP connectors.

Custom MCP connectors are available on business and enterprise Gemini plans and are enabled by a Google Workspace administrator. Labels vary by plan; if you don't see an option to add connectors, ask your admin.

2
Ask your admin to add WorkStory.

In the Gemini or Gemini Enterprise admin console, add a new MCP connector using the server URL below and choose sign-in (OAuth) authentication.

https://app.workstory.team/mcp
3
Connect your account once.

The first time you use WorkStory in Gemini, you'll be sent to WorkStory to log in and approve access. Gemini only sees what your WorkStory account can see.

4
Ask a question normally.

Name WorkStory, a person, team, or review cycle to get an answer grounded in your data.

Not sure which Gemini you have?

If you type commands in a terminal, it's Gemini CLI — use the left card. If you open Gemini in a browser or inside Gmail, Docs, or Drive with your work account, it's the app — use the right card and loop in your admin. Either way the MCP server address is the same: https://app.workstory.team/mcp.

Related use cases

Explore what else you can ask WorkStory.

Browse practical examples for HR, managers, and employees—each built around a focused question and a useful next step.

HR & People Teams

Track Team Engagement Over Time

Compare pulse survey results across periods, understand what is improving or declining by team, and spot unusually positive or negative responses that may warrant thoughtful follow-up.

View use case →

Employees

See Your Growth Story Over Time

Turn a year of scattered feedback into one clear story—how your strengths, recognition, and recurring themes have shifted over time.

View use case →

Employees

Build Your Case for a Raise

Turn your recent impact and feedback into clear, quantified talking points for a compensation conversation—instead of walking in with just a feeling that you deserve more.

View use case →

Employees

Turn Recurring Feedback into a Growth Plan

See the one theme that keeps showing up across your feedback, and turn it into a simple plan you can start working on today—no manager or HR required.

View use case →

Employees

Build Your Case for a Promotion

Turn your own recognition, scope growth, and recurring strengths into a clear case you can bring to your manager—instead of hoping they remember every win.

View use case →

HR & People Teams

Build a Quarterly Org Health Snapshot

Generate a quarterly rollup—engagement trend, top org-wide risks, biggest wins—straight from WorkStory data, instead of manually assembling a slide every quarter.

View use case →

HR & People Teams

Spot Managers Who Need Coaching Support

People leave managers, not companies. See which managers are getting recurring negative signals from their own teams, so you can step in with coaching before it turns into attrition.

View use case →

Managers

Present an Employee for a Promotion

Turn months of recognition, scope growth, and recurring strengths into a clear, evidence-backed promotion case—instead of trying to remember it all the night before the committee meets.

View use case →

HR & People Teams

Build a Performance Improvement Plan (PIP)

Turn someone's feedback history into a structured PIP—the specific gap, dated examples, a clear improvement goal, and a 30/60/90-day check-in plan—grounded in evidence instead of memory.

View use case →

HR & People Teams

Track Performance Review Cycle Status

See every review’s status in one place, understand which stage it is in, and know exactly who HR should follow up with before deadlines slip.

View use case →

HR & People Teams

Spot Retention Risk Early

Turn feedback trends into an early warning system—see which employees show signs of disengagement, then build a plan with their manager before it's too late.

View use case →

Managers

Prepare a Better 1:1

Turn recent WorkStory feedback into a focused conversation that recognizes strengths, addresses one important coaching opportunity, and ends with a clear next step.

View use case →
Data access

It only sees what you can see.

Connecting WorkStory does not expand anyone's access.

⌂

Your company only

Every request is limited to the company connected to the signed-in WorkStory account.

◎

Your permissions only

Gemini follows the same access rules as the WorkStory web app.

✓

Answers do not change data

Looking up information is read-only. If you ask to send a feedback request, you must approve it first.

Control

You stay in charge.

01

Everyday questions are read-only. Gemini can retrieve authorized WorkStory information without changing it.

02

Feedback requests need approval. Before a request is sent, you see what will happen and confirm it.

03

Disconnect whenever you want. Remove the workstory entry from settings.json, or ask your admin to disable the connector.

Troubleshooting

Quick fixes.

WorkStory is not appearing.

Gemini CLI: make sure settings.json is valid JSON and run /mcp after restarting. Gemini app: confirm your admin has enabled the WorkStory connector for your account.

It answers without WorkStory.

Start a new conversation, confirm the connector is enabled, and name WorkStory or a specific person, team, or review cycle.

Gemini cannot reach the server.

Check the server URL is exactly https://app.workstory.team/mcp, sign in again, then restart Gemini CLI or start a fresh conversation in the app.

It cannot find a person or review.

Check that the item is visible to your account in the WorkStory web app. The connector cannot widen access.

Support

Need a hand?

Email us for help connecting WorkStory, checking access, or troubleshooting an unexpected answer.

Email hello@workstory.team → Explore WorkStory MCP Read our privacy policy
WorkStory + Gemini

Ask better questions with real performance context.

Connect WorkStory, name the person, team, or review cycle you care about, and get an answer grounded in the data you are allowed to access.

Connect WorkStory ↑