MCP Integration Guide
cc-company works with MCP (Model Context Protocol) servers. Setting up MCP servers allows the secretary to directly operate external services.
How It Works
No special configuration is needed on the cc-company side. Just add MCP servers to Claude Code, and the secretary will automatically use them.
You: Schedule a meeting with Company A tomorrow at 2pm
Secretary: Added to your calendar!
I've also added "Prepare meeting materials for Company A" to your TODOs.Recommended MCP Servers
Notion (Official)
Connect with your knowledge base and databases. The secretary can read and update Notion pages.
Method 1: OAuth (Recommended)
claude mcp add-json notion '{"type":"http","url":"https://mcp.notion.com/mcp"}'After running, OAuth authentication opens in your browser. No manual API key setup needed.
Method 2: API Token
claude mcp add notion -e NOTION_TOKEN=ntn_YOUR_TOKEN -- npx -y @notionhq/notion-mcp-serverCreate an API token at Notion Integrations.
Capabilities:
- Read, create, and update Notion pages
- Search and update databases
- Secretary can reference your existing knowledge base
Google Calendar
Schedule management. The secretary can register meetings and set reminders.
claude mcp add google-calendar \
-e GOOGLE_OAUTH_CREDENTIALS=/path/to/gcp-oauth.keys.json \
-- npx -y @cocal/google-calendar-mcpPrerequisites:
- Create a project in Google Cloud Console
- Enable the Calendar API
- Create OAuth 2.0 credentials (Desktop app type)
- Download the credentials JSON
Capabilities:
- Create, view, modify, and delete events
- Show today's/this week's schedule
- Check availability
- Manage recurring events
GitHub (Official)
Repository management. Great synergy with the Engineering department.
Method 1: HTTP (Recommended)
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'Method 2: Docker
claude mcp add github \
-e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_PAT \
-- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-serverCreate a token at GitHub Settings > Developer settings > Personal access tokens.
Capabilities:
- Create, view, and search issues
- Manage and review PRs
- Check repository status
- Code search
Slack (Official)
Team communication. Works well with Sales and PM departments.
Method 1: OAuth (Recommended)
claude mcp add-json slack '{"type":"http","url":"https://mcp.slack.com/mcp","oauth":{"clientId":"1601185624273.8899143856786","callbackPort":3118}}'After running, Slack OAuth authentication opens in your browser.
Method 2: Install as plugin
claude plugin install slackCapabilities:
- Send and check messages
- Monitor channel activity
- Look up user info
- Client communication reminders
Note
Your workspace admin must have approved MCP integration.
Setup Methods
Via Command (Recommended)
Just run the claude mcp add commands above. Restart Claude Code after setup.
Manual Configuration
Global settings (all projects): ~/.claude/settings.json
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}Project settings (specific project only): .claude/settings.json
TIP
Put frequently used services (calendar, Notion) in global settings, and project-specific ones (GitHub) in project settings.
Examples with the Secretary
Once MCP servers are set up, the secretary uses them naturally.
> What's my schedule this week?
Secretary: Let me check your calendar.
- Monday 10:00 Weekly meeting with Company A
- Wednesday 14:00 Hearing with Company B
- Friday All day Tax filing deadline
Is the proposal for Company B on Wednesday ready?
> Summarize the meeting notes with Company A in Notion
Secretary: Done. Created a meeting notes page in Notion.
I've also saved a summary in secretary/notes/.
> Create an issue for this bug
Secretary: Created an issue on GitHub.
I've also logged it in engineering/debug-log/.Works Without MCP Too
cc-company works perfectly fine without any MCP servers. The secretary functions fully with just file management within .company/.
MCP is a "nice to have" option.