Ctrl+K

MCP Server Beta

MCP Server Beta#

Beta

The MCP server is in beta. You can connect and build with it today, but the available tools, scopes, and configuration may change while it’s in beta. Access and usage policies are subject to change when it moves out of beta, and it isn’t yet covered by standard production support. We’re actively expanding it, and your feedback shapes what ships.

The Workiva MCP server gives AI coding assistants direct access to Workiva platform capabilities through the Model Context Protocol (MCP).

Connecting to the MCP server#

Pick your MCP client and the region that hosts your Workiva account. You can connect to the full server or to an individual toolset. Authentication uses OAuth: when your client connects for the first time, a browser window opens so you can sign in to Workiva.

Run the following command to add the Workiva MCP server with all toolsets:

claude mcp add --transport http workiva https://mcp.app.wdesk.com/mcp

Or add a single toolset:

claude mcp add --transport http workiva-documents https://mcp.app.wdesk.com/x/documents
claude mcp add --transport http workiva-grc-graph-tools https://mcp.app.wdesk.com/x/grc_graph_tools
claude mcp add --transport http workiva-grc-tools https://mcp.app.wdesk.com/x/grc_tools
claude mcp add --transport http workiva-public-api-documentation https://mcp.app.wdesk.com/x/public_api_documentation
claude mcp add --transport http workiva-spreadsheets https://mcp.app.wdesk.com/x/spreadsheets
claude mcp add --transport http workiva-wdata https://mcp.app.wdesk.com/x/wdata

Then start Claude Code and run /mcp to authenticate with your Workiva account.

Run the following command to add the Workiva MCP server with all toolsets:

claude mcp add --transport http workiva https://mcp.eu.wdesk.com/mcp

Or add a single toolset:

claude mcp add --transport http workiva-documents https://mcp.eu.wdesk.com/x/documents
claude mcp add --transport http workiva-grc-graph-tools https://mcp.eu.wdesk.com/x/grc_graph_tools
claude mcp add --transport http workiva-grc-tools https://mcp.eu.wdesk.com/x/grc_tools
claude mcp add --transport http workiva-public-api-documentation https://mcp.eu.wdesk.com/x/public_api_documentation
claude mcp add --transport http workiva-spreadsheets https://mcp.eu.wdesk.com/x/spreadsheets
claude mcp add --transport http workiva-wdata https://mcp.eu.wdesk.com/x/wdata

Then start Claude Code and run /mcp to authenticate with your Workiva account.

Run the following command to add the Workiva MCP server with all toolsets:

claude mcp add --transport http workiva https://mcp.apac.wdesk.com/mcp

Or add a single toolset:

claude mcp add --transport http workiva-documents https://mcp.apac.wdesk.com/x/documents
claude mcp add --transport http workiva-grc-graph-tools https://mcp.apac.wdesk.com/x/grc_graph_tools
claude mcp add --transport http workiva-grc-tools https://mcp.apac.wdesk.com/x/grc_tools
claude mcp add --transport http workiva-public-api-documentation https://mcp.apac.wdesk.com/x/public_api_documentation
claude mcp add --transport http workiva-spreadsheets https://mcp.apac.wdesk.com/x/spreadsheets
claude mcp add --transport http workiva-wdata https://mcp.apac.wdesk.com/x/wdata

Then start Claude Code and run /mcp to authenticate with your Workiva account.

Run the following command to add the Workiva MCP server with all toolsets:

claude mcp add --transport http workiva https://mcp.ca.wdesk.com/mcp

Or add a single toolset:

claude mcp add --transport http workiva-documents https://mcp.ca.wdesk.com/x/documents
claude mcp add --transport http workiva-grc-graph-tools https://mcp.ca.wdesk.com/x/grc_graph_tools
claude mcp add --transport http workiva-grc-tools https://mcp.ca.wdesk.com/x/grc_tools
claude mcp add --transport http workiva-public-api-documentation https://mcp.ca.wdesk.com/x/public_api_documentation
claude mcp add --transport http workiva-spreadsheets https://mcp.ca.wdesk.com/x/spreadsheets
claude mcp add --transport http workiva-wdata https://mcp.ca.wdesk.com/x/wdata

Then start Claude Code and run /mcp to authenticate with your Workiva account.

Run the following commands to add the Workiva MCP server with all toolsets and sign in:

codex mcp add workiva --url https://mcp.app.wdesk.com/mcp
codex mcp login workiva

Or add a single toolset:

codex mcp add workiva-documents --url https://mcp.app.wdesk.com/x/documents
codex mcp add workiva-grc-graph-tools --url https://mcp.app.wdesk.com/x/grc_graph_tools
codex mcp add workiva-grc-tools --url https://mcp.app.wdesk.com/x/grc_tools
codex mcp add workiva-public-api-documentation --url https://mcp.app.wdesk.com/x/public_api_documentation
codex mcp add workiva-spreadsheets --url https://mcp.app.wdesk.com/x/spreadsheets
codex mcp add workiva-wdata --url https://mcp.app.wdesk.com/x/wdata

Alternatively, add the following to your ~/.codex/config.toml file:

[mcp_servers.workiva]
url = "https://mcp.app.wdesk.com/mcp"

Run the following commands to add the Workiva MCP server with all toolsets and sign in:

codex mcp add workiva --url https://mcp.eu.wdesk.com/mcp
codex mcp login workiva

Or add a single toolset:

codex mcp add workiva-documents --url https://mcp.eu.wdesk.com/x/documents
codex mcp add workiva-grc-graph-tools --url https://mcp.eu.wdesk.com/x/grc_graph_tools
codex mcp add workiva-grc-tools --url https://mcp.eu.wdesk.com/x/grc_tools
codex mcp add workiva-public-api-documentation --url https://mcp.eu.wdesk.com/x/public_api_documentation
codex mcp add workiva-spreadsheets --url https://mcp.eu.wdesk.com/x/spreadsheets
codex mcp add workiva-wdata --url https://mcp.eu.wdesk.com/x/wdata

Alternatively, add the following to your ~/.codex/config.toml file:

[mcp_servers.workiva]
url = "https://mcp.eu.wdesk.com/mcp"

Run the following commands to add the Workiva MCP server with all toolsets and sign in:

codex mcp add workiva --url https://mcp.apac.wdesk.com/mcp
codex mcp login workiva

Or add a single toolset:

codex mcp add workiva-documents --url https://mcp.apac.wdesk.com/x/documents
codex mcp add workiva-grc-graph-tools --url https://mcp.apac.wdesk.com/x/grc_graph_tools
codex mcp add workiva-grc-tools --url https://mcp.apac.wdesk.com/x/grc_tools
codex mcp add workiva-public-api-documentation --url https://mcp.apac.wdesk.com/x/public_api_documentation
codex mcp add workiva-spreadsheets --url https://mcp.apac.wdesk.com/x/spreadsheets
codex mcp add workiva-wdata --url https://mcp.apac.wdesk.com/x/wdata

Alternatively, add the following to your ~/.codex/config.toml file:

[mcp_servers.workiva]
url = "https://mcp.apac.wdesk.com/mcp"

Run the following commands to add the Workiva MCP server with all toolsets and sign in:

codex mcp add workiva --url https://mcp.ca.wdesk.com/mcp
codex mcp login workiva

Or add a single toolset:

codex mcp add workiva-documents --url https://mcp.ca.wdesk.com/x/documents
codex mcp add workiva-grc-graph-tools --url https://mcp.ca.wdesk.com/x/grc_graph_tools
codex mcp add workiva-grc-tools --url https://mcp.ca.wdesk.com/x/grc_tools
codex mcp add workiva-public-api-documentation --url https://mcp.ca.wdesk.com/x/public_api_documentation
codex mcp add workiva-spreadsheets --url https://mcp.ca.wdesk.com/x/spreadsheets
codex mcp add workiva-wdata --url https://mcp.ca.wdesk.com/x/wdata

Alternatively, add the following to your ~/.codex/config.toml file:

[mcp_servers.workiva]
url = "https://mcp.ca.wdesk.com/mcp"

MCP is an open protocol supported by many clients. Configure your client with the server URL below and choose OAuth as the authentication method — your browser will open to sign in to Workiva.

Target

Server URL

All Workiva Tools

https://mcp.app.wdesk.com/mcp

Documents

https://mcp.app.wdesk.com/x/documents

Grc Graph Tools

https://mcp.app.wdesk.com/x/grc_graph_tools

Grc Tools

https://mcp.app.wdesk.com/x/grc_tools

Public Api Documentation

https://mcp.app.wdesk.com/x/public_api_documentation

Spreadsheets

https://mcp.app.wdesk.com/x/spreadsheets

Wdata

https://mcp.app.wdesk.com/x/wdata

MCP is an open protocol supported by many clients. Configure your client with the server URL below and choose OAuth as the authentication method — your browser will open to sign in to Workiva.

Target

Server URL

All Workiva Tools

https://mcp.eu.wdesk.com/mcp

Documents

https://mcp.eu.wdesk.com/x/documents

Grc Graph Tools

https://mcp.eu.wdesk.com/x/grc_graph_tools

Grc Tools

https://mcp.eu.wdesk.com/x/grc_tools

Public Api Documentation

https://mcp.eu.wdesk.com/x/public_api_documentation

Spreadsheets

https://mcp.eu.wdesk.com/x/spreadsheets

Wdata

https://mcp.eu.wdesk.com/x/wdata

MCP is an open protocol supported by many clients. Configure your client with the server URL below and choose OAuth as the authentication method — your browser will open to sign in to Workiva.

Target

Server URL

All Workiva Tools

https://mcp.apac.wdesk.com/mcp

Documents

https://mcp.apac.wdesk.com/x/documents

Grc Graph Tools

https://mcp.apac.wdesk.com/x/grc_graph_tools

Grc Tools

https://mcp.apac.wdesk.com/x/grc_tools

Public Api Documentation

https://mcp.apac.wdesk.com/x/public_api_documentation

Spreadsheets

https://mcp.apac.wdesk.com/x/spreadsheets

Wdata

https://mcp.apac.wdesk.com/x/wdata

MCP is an open protocol supported by many clients. Configure your client with the server URL below and choose OAuth as the authentication method — your browser will open to sign in to Workiva.

Target

Server URL

All Workiva Tools

https://mcp.ca.wdesk.com/mcp

Documents

https://mcp.ca.wdesk.com/x/documents

Grc Graph Tools

https://mcp.ca.wdesk.com/x/grc_graph_tools

Grc Tools

https://mcp.ca.wdesk.com/x/grc_tools

Public Api Documentation

https://mcp.ca.wdesk.com/x/public_api_documentation

Spreadsheets

https://mcp.ca.wdesk.com/x/spreadsheets

Wdata

https://mcp.ca.wdesk.com/x/wdata

Security and access#

The Workiva MCP server connects your AI agent to live Workiva data, so access is governed the same way the rest of the platform is.

  • Authenticated with OAuth 2.0. Your agent acts as you, never with broader access than your own account.

  • Scoped to your permissions. The server respects your existing Workiva permissions. An agent can only read what you can already read. It cannot see organizations, workspaces, or records you lack access to.

  • Workspace and organization bound. Every request is scoped to a specific organization and workspace. Tools require an organization ID and a workspace ID, so a call against one workspace never reaches another.

  • Read-only where it counts. The GRC tools are read-only and idempotent. They load and list controls, risks, processes, and issues. They do not modify your data.

  • Regional residency. Connect to the base URL for your region. Your requests stay within that region.

Available tools#

Documents

Tool

Description

get_cell_range

Read sparse cells for an A1 range from a direct document table reference.

get_footnotes

Get one or more footnotes from a document as an ordered page of rich-text paragraphs.

get_section

Get a section from a document’s outline.

list_document

List documents in a workspace, optionally filtered by name.

list_link

List links for a table (range links plus destination links held in table cells), rich text (anchors), or resolve a destination link.

list_section

List the sections in a document’s outline.

search_fulltext_document

Search the full text content of documents.

Grc Graph Tools

Tool

Description

grc_graph_get_form

Retrieve a hydrated form for a graph vertex, with current property values and edge data filled in.

grc_graph_get_form_definition

Retrieve the form definition (template/schema) for a vertex type.

grc_graph_get_phase_type_statuses

Retrieve the set of possible statuses for test phases (e.g., not started, in testing, in review, complete).

grc_graph_get_prior_toc_metadata

Retrieve metadata from the prior testing period for a test of control.

grc_graph_get_report

Execute a report and return its row data.

grc_graph_get_reports

List all reports in the workspace as a folder tree.

grc_graph_get_reviews_and_logs

Retrieve reviews (approvals, rejections, assignments with reviewer and status) and a chronological activity log for a form.

grc_graph_get_sox_programs

List SOX audit programs for the current workspace.

grc_graph_get_test_form

Look up a single test of control by ID and retrieve its detailed form data, including the list of its test phases (with vertex IDs), attribute matrices, timing, form section IDs, and control information.

grc_graph_get_test_form_list

Retrieve a tabular summary of test forms, queryable by program_id or specific toc_ids.

grc_graph_get_test_forms_by_program_id

Retrieve all tests of control for an audit program and the program’s test form groups (vertexId, name, accessibility).

grc_graph_get_test_phase_form

Retrieve detailed form data for a single test phase (phase vertex IDs come from grc_graph_get_test_form), including attribute matrices, timing window, testing status (not started / in testing / returned / in review / review complete), supplemental files, and section form IDs.

grc_graph_get_test_phase_review_plan_items

Retrieve the review plan for a test phase: who reviews, in what role, their status, due date, and which review is currently active.

grc_graph_get_test_phase_review_plan_types

List all review plan type definitions (e.g., preparer, reviewer, approver).

grc_graph_get_test_phase_types

Retrieve test phase type definitions (e.g., design effectiveness, operating effectiveness) for an audit program or test of control.

grc_graph_get_test_steps

Get test steps and their attributes for a test phase.

Grc Tools

Tool

Description

grc_aggregate_controls

Aggregates controls in the current workspace by various dimensions — process, owner, significance, location, system, dimensionality type, and test/assessment aging.

grc_get_control

Loads a single control by its ID.

grc_get_governance_workspace_settings

Loads the governance workspace settings: whether multi-instance controls (MIC) are enabled, and who is emailed when a control suggestion is submitted.

grc_get_issue

Loads a single remediation issue by its ID with full details including findings, sources (workpaper, audit project, assessment, or CPM task), associated controls/processes, custom fields, and resolution metadata.

grc_get_policy

Loads a single policy by its ID, including its latest document and sections.

grc_get_process

Loads a single process by its ID with full details including associated sub-processes, controls, risks, flowchart, and narrative.

grc_get_process_risks_by_ids

Loads multiple process risks by their IDs in a single call.

grc_get_sub_process

Loads a single sub-process by its ID with full details including parent process, controls, risks, flowchart, and narrative.

grc_list_analytics_views

Get the available GRC analytics views.

grc_list_controls

Lists controls in the current workspace with filtering, search, and pagination.

grc_list_issues

Lists remediation issues in the current workspace with filtering and pagination.

grc_list_locations

Lists all locations defined in the current workspace with optional filtering and pagination.

grc_list_policies

Lists policies in the current workspace with filtering and pagination.

grc_list_process_risks

Lists process risks in the current workspace with filtering, search, and pagination.

grc_list_processes

Lists processes in the current workspace with filtering and pagination.

grc_list_sub_processes

Lists sub-processes in the current workspace with filtering and pagination.

grc_list_systems

Lists all systems defined in the current workspace with optional filtering and pagination.

grc_run_analytics_query

Execute an analytics query against a view discovered via grc_list_analytics_views and return rows of data.

grc_search_policy_sections

Searches policy document sections by semantic similarity to a natural-language query.

Public Api Documentation

Tool

Description

list_pages

List all available documentation pages.

read_page

Read the full content of a documentation page by its relative path (e.g.

search_docs

Search the API documentation by keyword.

Spreadsheets

Tool

Description

get_cell_range

Read sparse cells for a sheet-local A1 range through the sheet’s backing table.

list_sheet

List the sheets (tabs) in a spreadsheet.

list_spreadsheet

List spreadsheets in a workspace, optionally filtered by name.

Wdata

Tool

Description

download_query_result

Downloads a completed query result as CSV text.

get_query

Returns a saved query’s SQL text, parameters — including valid choices for select-mode parameters — and table dependencies.

get_query_result

Retrieves metadata for a query result.

get_table

Returns detailed schema for a single wdata table by ID, including all columns with their types and modes, plus description, table type, status, and timestamps.

list_table

Lists available wdata tables in a workspace.

run_query

Executes a query and returns immediately with a queryResultId and RUNNING status.

search_query

Searches saved queries in a workspace by matching a search term against query names.