Sharesight-MCP
Docker app from Eurotimmy's Repository
An MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio: portfolios, holdings, trades, payouts, performance and tax reports,…
Requirements
Overview
An MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio: portfolios, holdings, trades, payouts, performance and tax reports, cash accounts and more. Unofficial; uses the Sharesight v3 API.
:: BEFORE YOU START ::
You need Sharesight API access. Request it from support@sharesight.com, then copy your Client ID and Client Secret from your Sharesight API application. API access may require a particular Sharesight plan.
:: QUICK START ::
- Enter your Sharesight Client ID and Client Secret.
- Set MCP Auth Token to a long random string (e.g. run: openssl rand -hex 32). The container will not start without it. Every MCP client must send it as: Authorization: Bearer YOUR_TOKEN
- Start the container. The MCP endpoint is http://SERVER:3000/mcp and a health check is at /healthz.
:: SAFE BY DEFAULT ::
This template starts in READ-ONLY mode (read tools only). Set Read-only mode to false only if you want the AI to be able to create, change or delete trades, payouts and other data in Sharesight.
:: SECURITY ::
This server holds credentials to your financial data. Keep it on your LAN or VPN (e.g. Tailscale). If you publish it through a reverse proxy, put strong authentication in front of it and never share the auth token.
This is a community template. It is not affiliated with Sharesight or the sharesight-mcp authors. Please report template problems via the Support link.
Readme
View on GitHubSharesight MCP for Unraid
Unraid Community Applications template for lethek/sharesight-mcp, an unofficial MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio through the Sharesight v3 API.
This is a community template. It is not affiliated with Sharesight or the sharesight-mcp authors. Questions about the server itself belong on the project repo; template questions go to the support link in the template.
What you need first
- Sharesight API access. Email support@sharesight.com to request it. Sharesight may require a particular plan.
- Your API application's Client ID and Client Secret.
Quick start
- Install Sharesight-MCP from Community Applications.
- Enter your Sharesight Client ID and Sharesight Client Secret.
- Set MCP Auth Token to a long random string. On the Unraid terminal you can run
openssl rand -hex 32. The container refuses to start without it. - Start the container. Check
http://SERVER:3000/healthzreturns OK. - Point your MCP client at
http://SERVER:3000/mcpwith the headerAuthorization: Bearer YOUR_TOKEN.
Example for Claude Code:
claude mcp add --transport http sharesight http://SERVER:3000/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Read-only by default
The upstream server defaults to read and write. This template defaults Read-only mode (MCP_READ_ONLY) to true, which leaves only the read tools and removes everything that creates, changes or deletes data. Set it to false only if you want your AI assistant to be able to edit Sharesight.
Settings
| Setting | Variable | Default | Notes |
|---|---|---|---|
| MCP port | container 3000 |
3000 |
Change the host side if 3000 is taken. |
| Sharesight Client ID | SHARESIGHT_CLIENT_ID |
Required. | |
| Sharesight Client Secret | SHARESIGHT_CLIENT_SECRET |
Required. Masked. | |
| MCP Auth Token | MCP_AUTH_TOKEN |
Required. Masked. | |
| Read-only mode | MCP_READ_ONLY |
true |
Upstream default is false. |
| Cursor secret | MCP_CURSOR_SECRET |
random per start | Set it so paging cursors survive restarts. |
| Max response characters | MCP_MAX_RESPONSE_CHARS |
30000 |
Minimum 5000. |
| Holdings cache (seconds) | MCP_CACHE_TTL_SECONDS |
60 |
0 disables. |
| Attachments folder | path /attachments (read-only) |
Optional. | |
| Attachments root | MCP_DATA_ROOT |
empty | Set to /attachments to enable attachment uploads. |
| Max attachment size | MCP_MAX_ATTACHMENT_BYTES |
10485760 |
Bytes. |
| Sharesight API base URL | SHARESIGHT_BASE_URL |
https://api.sharesight.com |
Leave as is. |
Security
This container holds credentials that can read (and, if you allow it, change) your financial records.
- Keep it on your LAN or a VPN such as Tailscale.
- If you publish it through a reverse proxy, add strong authentication in front of it.
- Treat the auth token like a password and rotate it if it leaks.
- Sharesight requires TLS 1.3 from 30 September 2026. The image is built on Node 24, which supports it.
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/lethek/sharesight-mcp:mainRuntime arguments
- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--restart=unless-stopped
Template configuration
HTTP port for the MCP endpoint (/mcp) and health check (/healthz). Change the host port if 3000 is already in use.
- Target
- 3000
- Default
- 3000
- Value
- 3000
Client ID of your Sharesight API application.
- Target
- SHARESIGHT_CLIENT_ID
Client Secret of your Sharesight API application.
- Target
- SHARESIGHT_CLIENT_SECRET
Required. A long random string (e.g. openssl rand -hex 32). Clients must send it as an 'Authorization: Bearer' header. The container will not start without it.
- Target
- MCP_AUTH_TOKEN
true (default here) removes every tool that creates, changes or deletes Sharesight data. Set false to allow writes.
- Target
- MCP_READ_ONLY
- Default
- true|false
- Value
- true
Optional. Signs pagination cursors. If empty, a new random value is used on every start, so cursors stop working after a restart. Set any long random string to keep them valid.
- Target
- MCP_CURSOR_SECRET
Size limit for one page of a list, in characters (minimum 5000). Keep it under your AI client's tool-output limit.
- Target
- MCP_MAX_RESPONSE_CHARS
- Default
- 30000
- Value
- 30000
How long the holdings list is cached for later pages. 0 turns the cache off.
- Target
- MCP_CACHE_TTL_SECONDS
- Default
- 60
- Value
- 60
Optional. Host folder holding files (e.g. contract notes) the AI may attach to trades and payouts. Only used when Read-only mode is false and Attachments root is set to /attachments.
- Target
- /attachments
Optional. Set to /attachments to enable uploading attachments from the folder above. Leave empty if you do not use attachments (the server refuses to start if this points to a folder that does not exist).
- Target
- MCP_DATA_ROOT
Largest attachment, in bytes.
- Target
- MCP_MAX_ATTACHMENT_BYTES
- Default
- 10485760
- Value
- 10485760
Leave as is unless you are testing or using a proxy. Must be https.
- Target
- SHARESIGHT_BASE_URL
- Default
- https://api.sharesight.com
- Value
- https://api.sharesight.com